{"uid":"cap_3LKDLnL8PJSMovLPMBvOx","slug":"meta-ad-library-search-via-sitecheck-shop-social-52fcfd59","name":"Meta Ad Library Search via SiteCheck Shop & Social","description":"Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.","url":"https://api.shopsocial-api.workers.dev/api/social/facebook-ads-library?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","required":[],"properties":{"q":{"type":"string","description":"Search words (or use pageIds)"},"limit":{"type":"string","description":"1 to 50 ads (default 10)"},"adType":{"type":"string","description":"ALL or POLITICAL_AND_ISSUE_ADS (default). ALL only returns ads for EU/UK countries"},"country":{"type":"string","description":"Two-letter country the ads reached, e.g. US, DE (ALL for every country)"},"pageIds":{"type":"string","description":"Up to 10 Facebook page IDs, comma separated"},"activeStatus":{"type":"string","description":"ACTIVE, INACTIVE or ALL (default ALL)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ok8cEg3I820WvGpH2Rvdm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Meta's Ad Library API by keyword or Facebook page IDs and country, returning ad metadata including creative text, spend/impression ranges, delivery dates, and platform info.","exampleAgentPrompt":"Can you pull up all active Facebook ads mentioning 'climate change' that were delivered in the US from Meta's Ad Library — political and issue ads only, show me up to 20 results?","exampleUseCases":[{"title":"Competitive ad intelligence research","prompt":"Find me up to 25 ads currently running on Facebook from page ID 123456789 targeting Germany — I want to see what creative text they're using and how long the ads have been running."},{"title":"Political ad spend monitoring","prompt":"Search Meta's Ad Library for political and issue ads about 'immigration policy' delivered in the US, and tell me the spend and impression ranges for any you find — show me all active ones."},{"title":"EU advertising compliance audit","prompt":"Pull all Facebook and Instagram ads delivered in France from page IDs 111222333 and 444555666 — I need the funding byline, platforms, languages, and EU reach data for each ad."}],"resultDescription":"Returns a list of ads matching the query, each containing: ad ID, Facebook page name and ID, funding entity/byline, ad creation and delivery dates, creative text (titles, body, captions), snapshot URL, platforms delivered on, languages, and for political/issue ads the spend and impression ranges. EU ads also include estimated EU reach figures.","failureModes":["Missing or invalid Ad Library API token returns an authentication error","Country code not recognized returns empty or error response","pageIds exceeding 10 entries may be rejected","adType=ALL with a non-EU/UK country returns empty results since ALL only works for EU/UK","No matching ads found returns empty list with no error","Rate limits from Meta's underlying API may cause failures","Invalid q or pageIds format may return an error or empty results"],"whenToPreferThis":"Use this endpoint when you need to search Meta's Ad Library for ads by keyword or specific Facebook page IDs, especially for political/issue ad transparency research, competitive intelligence, or EU advertising compliance. Prefer it over general web scraping when you need structured ad metadata including spend ranges, impression data, and creative text directly from Meta's official data source. Requires a free Meta Ad Library API token from the operator.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:34.438Z","isFirstParty":false,"canonicalSlug":"meta-ad-library-search-via-sitecheck-shop-social-52fcfd59"}