{"uid":"cap_oWjP_slRF3rPfyEe5TsDx","slug":"agdata-meta-ad-library-api-00ecfa34","name":"agdata Meta Ad Library API","description":"Meta ad library API for AI agents, for competitor research: send a keyword or an advertiser (name or page id) and get its public ads as JSON: advertiser, start and end date, whether it is still running, platforms, text, title, call to action, link, format and image URLs. Filter by country and by active or all ads; up to 100 per call, each ad once. Pay per call in stablecoins; an empty search is not charged and ads you paid for but did not get are refunded.","url":"https://agdata.shveik.dev/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":null,"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_USBqWyNJYjXCGqv060HYA","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":"Fetches public Meta (Facebook/Instagram) ads for a given advertiser or keyword, returning structured ad data for competitor research.","exampleAgentPrompt":"Pull up to 50 active Meta ads from Nike's Facebook page — I want to see the ad text, titles, call to action, links, image URLs, and which platforms they're running on, filtered to the US.","exampleUseCases":[{"title":"Competitor ad creative research","prompt":"Show me all currently active Facebook and Instagram ads from Gymshark — I want their ad copy, images, and what call-to-action buttons they're using, limited to US ads, up to 100 results."},{"title":"Keyword-based ad landscape scan","prompt":"Search the Meta ad library for any ads mentioning 'protein powder' — give me up to 50 results including who's advertising, what they're saying, and whether the ads are still running."},{"title":"Brand ad monitoring by country","prompt":"Fetch all Meta ads — active and inactive — from the Glossier Facebook page that ran in the UK, up to 100 ads, so I can see their historical UK ad strategy."}],"resultDescription":"A JSON array of up to 100 ads, each containing: advertiser name, ad start and end dates, whether the ad is still active, platforms it ran on (Facebook/Instagram/etc.), ad text body, title, call-to-action label, destination link, ad format, and image URLs. Empty searches are not billed; any ads paid for but not returned are refunded.","failureModes":["No ads found for query — returns empty result and no charge","Invalid page name or page ID — returns error with no charge","Country code not recognized — returns validation error","Both keyword and page omitted — returns error, no charge","Rate limiting or Meta API unavailability — may return 5xx error","Limit exceeds 100 — rejected by schema validation"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Meta ad data (Facebook/Instagram) for a specific advertiser or keyword, especially for competitor research, ad creative analysis, or monitoring brand activity. It is preferable to manual Meta Ad Library browsing or scraping, as it returns clean JSON with all key ad attributes. Use it when you need to filter by country or active-only ads and want pay-per-call pricing with no wasted spend on empty results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:30:06.897Z","isFirstParty":false,"canonicalSlug":"agdata-meta-ad-library-api-00ecfa34"}