{"uid":"cap_q8A7Cog074Z7V71SXgE6X","slug":"apitoll-facebook-ad-library-search-f304f073","name":"ApiToll Facebook Ad Library Search","description":"Facebook Ad Library search by keyword — every live and recent ad matching a search term across all advertisers on Facebook, Instagram, Messenger and Threads. Returns the full ad creative (headline, body copy, CTA button + destination link, image and video URLs), the advertiser, run dates and days-running, and platform mix. Commercial and political ads, no Meta API or login. Competitor ad intelligence, ad spy, and creative research for AI agents.","url":"https://ads.apitoll.cloud/v1/ads/facebook/search?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":["q"],"properties":{"q":{"type":"string","description":"Keyword/phrase to search ads for (e.g. \"running shoes\", \"crypto wallet\"). Defaults to a demo query if omitted."},"limit":{"type":"integer","maximum":60,"minimum":1,"description":"Max ads to return (1-60)."},"period":{"enum":["","last24h","last7d","last14d","last30d"],"type":"string","description":"Limit to ads active in this window. Blank = all time."},"ad_type":{"enum":["all","political_and_issue_ads","housing_ads","employment_ads","credit_ads","financial_products_and_services_ads"],"type":"string","description":"Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent)."},"country":{"type":"string","description":"Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US."},"sort_by":{"enum":["impressions_desc","most_recent"],"type":"string","description":"most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended)."},"platforms":{"type":"string","description":"Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all."},"media_type":{"enum":["all","image","video","meme","image_and_meme","none"],"type":"string","description":"Creative format filter."},"active_status":{"enum":["all","active","inactive"],"type":"string","description":"Filter by whether the ad is still running."},"resolve_advertiser":{"type":"boolean","description":"Also resolve each advertiser’s page identity (verified status, categories, profile pic). Slower. Default false."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ads":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"pageId":{"type":"string"},"country":{"type":"string"},"ctaText":{"type":"string"},"ctaType":{"type":"string"},"linkUrl":{"type":"string"},"bodyText":{"type":"string"},"isActive":{"type":"boolean"},"pageName":{"type":"string"},"videoUrl":{"type":"string"},"imageUrls":{"type":"array","items":{"type":"string"}},"scrapedAt":{"type":"string"},"sourceUrl":{"type":"string"},"startDate":{"type":"number"},"adArchiveId":{"type":"string"},"daysRunning":{"type":"number"},"linkUrlType":{"type":"string"},"pageVerified":{"type":"boolean"},"displayFormat":{"type":"string"},"templatedText":{"type":"boolean"},"mediaExpiresAt":{"type":"string"},"publisherPlatform":{"type":"array","items":{"type":"string"}}}}},"asOf":{"type":"string"},"count":{"type":"number"},"query":{"type":"object","properties":{"keyword":{"type":"string"}}},"source":{"type":"object","properties":{"via":{"type":"string"},"name":{"type":"string"}}},"country":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ads":[{"title":"Run Further in the new AeroGlide","pageId":"100066543210987","country":"US","ctaText":"Shop Now","ctaType":"SHOP_NOW","linkUrl":"https://acmefootwear.com/aeroglide?utm_source=fb","bodyText":"Lightweight cushioning for your longest runs. Free shipping this week.","isActive":true,"pageName":"Acme Footwear","videoUrl":"https://video.xx.fbcdn.net/v/ad_hd.mp4","imageUrls":["https://scontent.xx.fbcdn.net/v/img1.jpg"],"scrapedAt":"2026-06-25T14:32:09Z","sourceUrl":"https://www.facebook.com/ads/library/?q=running%20shoes&country=US","startDate":1717200000,"adArchiveId":"1234567890123456","daysRunning":28,"linkUrlType":"destination","pageVerified":true,"displayFormat":"VIDEO","templatedText":false,"mediaExpiresAt":"2026-06-29T22:19:28Z","publisherPlatform":["FACEBOOK","INSTAGRAM"]}],"asOf":"2026-06-25T14:32:10Z","count":25,"query":{"keyword":"running shoes"},"source":{"via":"Apify","name":"Facebook Ad Library"},"country":"US"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"0.97","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"3.0000","medianCents":"3.0000","p90Cents":"3.0000","minCents":"3.0000","maxCents":"3.0000","p95Cents":"3.0000","sampleCount":106,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__JQTrO_9R-JRSD2cVyPPx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes the Facebook Ad Library to return full ad creatives, run dates, advertiser info, and platform distribution for any keyword or brand search","exampleAgentPrompt":"Search the Facebook Ad Library for the top 30 active ads about 'electric vehicles' targeting US audiences from the last 30 days, sorted by impressions, and give me each ad's headline, body copy, CTA, landing page URL, and which platforms it ran on.","exampleUseCases":null,"resultDescription":"A JSON object containing a list of up to 60 ads, each with: title/headline, body copy, CTA text and type, destination link URL, image and video CDN URLs, advertiser page name and ID, page verification status, ad start date, days running, active status, publisher platforms (Facebook/Instagram/Messenger/Threads), display format, ad archive ID, country, and source URL. Also includes metadata: total count, query used, country, and timestamp of scrape.","failureModes":["Missing required 'q' parameter returns error or demo results","Invalid country code returns empty results or error","Meta Ad Library rate limiting or anti-scrape measures may return partial results","Political ad spend/impression data often absent even when ad_type filter is set","Video or image CDN URLs may expire shortly after retrieval","Very broad queries may hit the 60-ad cap and miss long-tail results","Payment failure (insufficient USDC balance) returns 402 before any data is fetched"],"whenToPreferThis":"Choose this endpoint when you need structured ad creative data from the Facebook Ad Library without a Meta developer account or login — especially for competitive research, brand monitoring, political ad tracking, or extracting landing page URLs and creative assets at scale. Prefer this over manual Ad Library browsing or the official Meta Marketing API when you need no-auth access, programmatic search by keyword or advertiser name, and full creative details including video URLs in a single paid-per-call call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":171,"lastUsedAt":"2026-10-05T18:53:51.747Z","lastSuccessfullyRanAt":"2026-10-05T18:53:16.182Z","lastHealthCheckAt":"2026-10-12T15:49:00.126Z","isFirstParty":false,"canonicalSlug":"apitoll-facebook-ad-library-search-f304f073"}