{"api":"v1","generated_at":"2026-09-15T18:56:50.309Z","licence":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"TOLL, with a link to the page cited"},"page":"https://tollindex.com/e/ads-apitoll-cloud-v1-ads-facebook-search-fd9648","pinned_page":"https://tollindex.com/e/ads-apitoll-cloud-v1-ads-facebook-search-fd9648/at/2026-09-15T16-57Z","pinned":false,"method":"https://tollindex.com/ledger/method","snapshot_at":"2026-09-15T16:57:44.360Z","snapshot_stamp":"2026-09-15T16-57Z","endpoint":{"slug":"ads-apitoll-cloud-v1-ads-facebook-search-fd9648","canonical_url":"https://ads.apitoll.cloud/v1/ads/facebook/search","resource":"https://ads.apitoll.cloud/v1/ads/facebook/search","http_method":"GET","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"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.","service_name":null,"declared_category":null,"declared_tags":["facebook-ads","ad-library","ads","keyword-search","ad-creative"],"route_template":null,"registry_updated":"2026-09-01T17:54:30.642Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"facebook search","category":"search","first_observed_by_toll":"2026-09-10T19:08:24.178Z","last_observed_by_toll":"2026-09-15T16:57:44.360Z","observation_began":"2026-09-10"},"presence":{"listed_now":true,"first_absent_at":null,"delisting_confirmed_at":null,"events":[{"registry":"cdp","at":"2026-09-10T19:08:24.178Z","event":"listed"}]},"accepts":[{"registry":"cdp","ordinal":0,"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","asset_name":"USD Coin","symbol":"USDC","decimals":6,"amount_display":"0.03 USDC","amount_units":0.03,"decimals_known":true,"pay_to":"0x4ce88238F669d04351937420C931988e464a975a","scheme":"exact"},{"registry":"cdp","ordinal":1,"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","asset_name":null,"symbol":"USDC","decimals":6,"amount_display":"0.03 USDC","amount_units":0.03,"decimals_known":true,"pay_to":"HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x","scheme":"exact"}],"counters":{"observed_at":"2026-09-15T16:57:44.360Z","calls_30d":1,"unique_payers_30d":1,"last_called_at":"2026-09-01T17:54:30.082Z"},"validation":{"latest":{"observed_at":"2026-09-15T07:08:42.691Z","state":"pass","failed_checks":[],"endpoint_http_status":402,"run_id":"daily-2026-09-15"},"uptime":[{"days":7,"observed":5,"passed":5,"ratio":1},{"days":30,"observed":5,"passed":5,"ratio":1},{"days":90,"observed":5,"passed":5,"ratio":1}],"history_90d":[{"observed_at":"2026-09-15T07:08:42.691Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T06:34:39.723Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T06:23:39.702Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T13:57:00.543Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T14:54:02.658Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-11","state_changed":true}]},"seller":{"wallet":"0x4ce88238F669d04351937420C931988e464a975a","page":"https://tollindex.com/seller/0x4ce88238F669d04351937420C931988e464a975a","endpoints":2,"hosts":1},"reports":0,"registry_record":{"cdp":[{"tags":["facebook-ads","ad-library","ads","keyword-search","ad-creative"],"type":"http","accepts":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"},"payTo":"0x4ce88238F669d04351937420C931988e464a975a","amount":"30000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":150},{"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","extra":{"feePayer":"GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"},"payTo":"HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x","amount":"30000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","maxTimeoutSeconds":150}],"quality":{"lastCalledAt":"2026-09-01T17:54:30.082Z","l30DaysTotalCalls":1,"l30DaysUniquePayers":1},"resource":"https://ads.apitoll.cloud/v1/ads/facebook/search","extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"q":"running shoes","country":"US"}},"output":{"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"}}},"schema":{"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"}}}}}}}}},"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.","lastUpdated":"2026-09-01T17:54:30.642Z","x402Version":2}]}}