{"uid":"cap_2tUKXJkWA2eFdtEbdIf7B","slug":"facebook-ad-library-search-via-orthogonal-e1f013bd","name":"Facebook Ad Library Search via Orthogonal","description":"Search Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.","url":"https://x402.orthogonal.com/scrapecreators/v1/facebook/adLibrary/search/ads?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"trim":{"type":"string","description":"Set to true for a trimmed response"},"query":{"type":"string","description":"Search query"},"cursor":{"type":"string","description":"Cursor for pagination For later cursor pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response."},"status":{"type":"string","description":"Status filter"},"ad_type":{"type":"string","description":"Ad type filter"},"country":{"type":"string","description":"Country filter"},"sort_by":{"type":"string","description":"Sort by"},"end_date":{"type":"string","description":"End date (YYYY-MM-DD)"},"media_type":{"type":"string","description":"Media type filter"},"start_date":{"type":"string","description":"Start date (YYYY-MM-DD)"},"search_type":{"type":"string","description":"Search type"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vsLBP2FOStPYZ7sFinzFy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and paginate through Facebook's Ad Library to discover active and historical ads matching query, filters, and date ranges","exampleAgentPrompt":"Search the Facebook Ad Library for active image ads from Nike in the US, sorted by relevance, and show me what they're currently running.","exampleUseCases":[{"title":"Competitor ad creative research","prompt":"Search the Facebook Ad Library for all active video ads from Coca-Cola targeting the United States — I want to see what creative campaigns they're running right now."},{"title":"Political ad monitoring by date","prompt":"Find political ads on Facebook from January 1, 2024 to March 31, 2024 in Germany — I'm researching election advertising spending during that period."},{"title":"Brand keyword ad discovery","prompt":"Look up Facebook ads containing the keyword 'weight loss' that are currently active, filter for image ads only, and sort by the most recent start date."}],"resultDescription":"Returns a list of Facebook Ad Library entries matching the query and filters, including ad creatives, advertiser metadata, active status, date ranges, and a pagination cursor for fetching subsequent pages. The Orthogonal response also includes a requestId for use as parentRequestId in free continuation calls.","failureModes":["Invalid or missing query parameter returns empty results","Unsupported country code returns an error or empty set","Invalid cursor causes pagination failure","Changing filter parameters while passing parentRequestId starts a new billable request","Rate limiting or upstream Meta Ad Library unavailability returns 5xx errors","Invalid date format (not YYYY-MM-DD) may cause query rejection"],"whenToPreferThis":"Use this endpoint when you need to programmatically search the Facebook Ad Library for ads by keyword, brand, country, or date range — especially when paginating large result sets cheaply using the parentRequestId continuation billing feature. Prefer this over manual Ad Library browsing when building competitive intelligence pipelines, ad monitoring workflows, or market research tools.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T00:38:38.472Z","isFirstParty":false,"canonicalSlug":"facebook-ad-library-search-via-orthogonal-e1f013bd"}