{"version":1,"service":{"name":"ApiToll Facebook Ad Library","description":"Scrape the public Facebook Ad Library — live + recent ads (creative, CTA, link, images, video, run dates) by keyword, advertiser, or page. Commercial + political ads across Facebook, Instagram, Messenger, Threads. Paid per call via x402 on Base + Solana.","tags":["facebook-ads","ad-library","competitor-intelligence","ad-creative","advertising","marketing","instagram-ads","ad-spy"],"category":"marketing","price":"$0.01","schemaUrl":"https://ads.apitoll.cloud/openapi.json"},"resources":[{"url":"https://ads.apitoll.cloud/v1/ads/facebook/search","summary":"Paid ($0.01): Search live Facebook/Instagram ads by keyword or advertiser name","params":{"q":"Keyword/phrase to search ads for (e.g. \"running shoes\", \"crypto wallet\"). Defaults to a demo query if omitted.","advertiser":"Advertiser/brand page NAME to find ads from (alternative to q). Ignored if q is set.","country":"Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US.","media_type":"Creative format filter.","ad_type":"Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent).","platforms":"Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all.","period":"Limit to ads active in this window. Blank = all time.","active_status":"Filter by whether the ad is still running.","sort_by":"impressions_desc (top ads) or most_recent (newest first).","limit":"Max ads to return (1-60).","resolve_advertiser":"Also resolve each advertiser’s page identity (verified status, categories, profile pic). Slower. Default false."}},{"url":"https://ads.apitoll.cloud/v1/ads/facebook/page","summary":"Paid ($0.01): All live ads from a specific advertiser’s Facebook page","params":{"page":"Facebook page URL (facebook.com/nike), vanity handle, profile.php?id=, or numeric page id. Defaults to a demo page if omitted.","country":"Two-letter ISO country (US, GB, DE…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US.","media_type":"Creative format filter.","ad_type":"Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent).","platforms":"Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all.","period":"Limit to ads active in this window. Blank = all time.","active_status":"Filter by whether the ad is still running.","sort_by":"impressions_desc (top ads) or most_recent (newest first).","limit":"Max ads to return (1-60).","resolve_advertiser":"Also resolve the page identity (verified status, categories, profile pic). Slower. Default false."}}],"examples":[{"description":"Search live Facebook/Instagram ads by keyword or advertiser name","url":"https://ads.apitoll.cloud/v1/ads/facebook/search?q=running+shoes&country=US"},{"description":"All live ads from a specific advertiser’s Facebook page","url":"https://ads.apitoll.cloud/v1/ads/facebook/page?page=https%3A%2F%2Fwww.facebook.com%2Fnike"}]}