{"uid":"cap_gJIi19pK8PqJPCRP4qexq","slug":"agdata-meta-ads-search-c76b844a","name":"agdata Meta Ads Search","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/mpp/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_FdikodZkOAqHM8ANcNiie","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 live Meta (Facebook/Instagram) ad data by page, keyword, country, or active status","exampleAgentPrompt":"Search the Meta ad library for active ads from the Nike Facebook page mentioning 'running shoes' in the US — show me up to 20 results.","exampleUseCases":[{"title":"Competitor ad campaign monitoring","prompt":"Pull up to 50 active Meta ads from the Adidas page right now so I can see what campaigns they're currently running."},{"title":"Keyword-based ad research","prompt":"Search Meta ads for any ads containing the keyword 'Black Friday' in the US, limit to 30 results, and include both active and inactive ones."},{"title":"Brand ad audit across platforms","prompt":"Get me all the current Meta ads running for the Apple page so I can audit their creative formats, CTAs, and which platforms they're appearing on."}],"resultDescription":"Returns a JSON array of ad records, each containing the ad ID, body text, title, call-to-action label, destination URL, page name and ID, image URLs, platforms (Facebook/Instagram), display format (IMAGE, VIDEO, etc.), start and end dates, and whether the ad is currently active.","failureModes":["Page name not found or misspelled — returns empty results","Keyword too short (minimum 2 characters) — returns validation error","Country code invalid — returns validation error","Limit out of range (must be 1–100) — returns validation error","Meta Ad Library rate-limited or temporarily unavailable — returns upstream error"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Meta ad data (Facebook/Instagram) without requiring a Meta developer account or ad account access. Ideal for competitive intelligence, ad monitoring, and brand research workflows that need to run autonomously via AI agents and pay per call in USDC with no subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:27.518Z","isFirstParty":false,"canonicalSlug":"agdata-meta-ads-search-c76b844a"}