{"uid":"cap_03A-7denwoEyrcWg0wva5","slug":"agdata-meta-ads-search-api-05491ff6","name":"agdata Meta Ads Search API","description":"Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.","url":"https://agdata.shveik.dev/v1/x402/meta-ads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"string","maxLength":100,"minLength":2},"limit":{"type":"integer","maximum":100,"minimum":1},"active":{"type":"boolean"},"country":{"type":"string"},"keyword":{"type":"string","maxLength":100,"minLength":2}}},"responseSchema":{"type":"json","example":{"cta":"Shop now","adId":"12345678…","text":"New seas…","title":"Shop the…","active":true,"pageId":"10000000…","endDate":null,"linkUrl":"https://…","pageName":"Example…","imageUrls":[],"platforms":[],"startDate":"2026-09-…","displayFormat":"IMAGE"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03775","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.03775/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03775","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03775","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oAUT3NTIfZXf5zwVhKlEM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03775","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and retrieve active or historical Meta (Facebook/Instagram) ads for a given page, keyword, or country as structured JSON","exampleAgentPrompt":"Can you pull up the active Meta ads for the Facebook page 'Nike' in the US — grab up to 50 results and filter for only the currently running ones?","exampleUseCases":[{"title":"Competitor ad creative research","prompt":"Show me all the active Facebook and Instagram ads that Nike is running right now in the United States — I want to see their headlines, images, and CTAs."},{"title":"Keyword-based ad trend monitoring","prompt":"Search Meta's ad library for any ads mentioning 'summer sale' running in the UK and return up to 30 results so I can see what brands are promoting."},{"title":"Brand ad history audit","prompt":"Get me all Meta ads — active and inactive — from the Facebook page 'Glossier' so I can review their past campaign messaging and creative formats."}],"resultDescription":"Returns a JSON array of Meta ad objects, each containing the ad ID, ad text, title, call-to-action label, destination URL, the Facebook page name and ID, image URLs, platforms the ad ran on (Facebook, Instagram, etc.), display format (IMAGE, VIDEO, etc.), start and end dates, and an active boolean flag indicating whether the ad is currently live.","failureModes":["Invalid or unknown page name returns empty results or 404","Country code not recognized returns an error or empty set","Keyword too short (under 2 chars) triggers schema validation rejection","Limit out of range (0 or >100) triggers validation error","Page has no ads in the Meta Ad Library returns empty array","Payment failure or insufficient USDC balance returns 402 error"],"whenToPreferThis":"Choose this endpoint when you need structured Meta (Facebook/Instagram) ad data — creatives, CTAs, targeting countries, active status — without scraping or a Meta developer account. Ideal for competitive intelligence, ad monitoring, and marketing research workflows that need programmatic access to the Meta Ad Library. Prefer it over general web scraping when you need clean, schema-consistent ad objects rather than raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:33:42.958Z","isFirstParty":false,"canonicalSlug":"agdata-meta-ads-search-api-05491ff6"}