{"slug":"ads-apitoll-cloud-v1-ads-facebook-search-ed09d7","title":"Facebook Ad Library search by keyword — every live and recent ad matching a sear","host":"ads.apitoll.cloud","method":"GET","resource":"https://ads.apitoll.cloud/v1/ads/facebook/search","category":"image","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-ru","price_listed":0.03,"price_asked":0.03,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":938,"reported_calls_30d":9,"reported_payers_30d":4,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"country":"US","q":"running shoes"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"active_status":{"description":"Filter by whether the ad is still running.","enum":["all","active","inactive"],"type":"string"},"ad_type":{"description":"Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent).","enum":["all","political_and_issue_ads","housing_ads","employment_ads","credit_ads","financial_products_and_services_ads"],"type":"string"},"country":{"description":"Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US.","type":"string"},"limit":{"description":"Max ads to return (1-60).","maximum":60,"minimum":1,"type":"integer"},"media_type":{"description":"Creative format filter.","enum":["all","image","video","meme","image_and_meme","none"],"type":"string"},"period":{"description":"Limit to ads active in this window. Blank = all time.","enum":["","last24h","last7d","last14d","last30d"],"type":"string"},"platforms":{"description":"Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all.","type":"string"},"q":{"description":"Keyword/phrase to search ads for (e.g. \"running shoes\", \"crypto wallet\"). Defaults to a demo query if omitted.","type":"string"},"resolve_advertiser":{"description":"Also resolve each advertiser’s page identity (verified status, categories, profile pic). Slower. Default false.","type":"boolean"},"sort_by":{"description":"most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended).","enum":["impressions_desc","most_recent"],"type":"string"}},"required":["q"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"ads":{"items":{"properties":{"adArchiveId":{"type":"string"},"bodyText":{"type":"string"},"country":{"type":"string"},"ctaText":{"type":"string"},"ctaType":{"type":"string"},"daysRunning":{"type":"number"},"displayFormat":{"type":"string"},"imageUrls":{"items":{"type":"string"},"type":"array"},"isActive":{"type":"boolean"},"linkUrl":{"type":"string"},"linkUrlType":{"type":"string"},"mediaExpiresAt":{"type":"string"},"pageId":{"type":"string"},"pageName":{"type":"string"},"pageVerified":{"type":"boolean"},"publisherPlatform":{"items":{"type":"string"},"type":"array"},"scrapedAt":{"type":"string"},"sourceUrl":{"type":"string"},"startDate":{"type":"number"},"templatedText":{"type":"boolean"},"title":{"type":"string"},"videoUrl":{"type":"string"}},"type":"object"},"type":"array"},"asOf":{"type":"string"},"count":{"type":"number"},"country":{"type":"string"},"query":{"properties":{"keyword":{"type":"string"}},"type":"object"},"source":{"properties":{"name":{"type":"string"},"via":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.03,"price_match":true,"latency_ms":938,"error":null}],"description_full":"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.","last_updated":"2026-09-24T02:15:03.455Z","schemes":["exact"]}