{"api":"v1","generated_at":"2026-09-15T18:58:55.806Z","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-advertiser-d1ae53","pinned_page":"https://tollindex.com/e/ads-apitoll-cloud-v1-ads-facebook-advertiser-d1ae53/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-advertiser-d1ae53","canonical_url":"https://ads.apitoll.cloud/v1/ads/facebook/advertiser","resource":"https://ads.apitoll.cloud/v1/ads/facebook/advertiser","http_method":"GET","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"description":"Facebook ads from a specific advertiser by brand name — every live and recent ad a brand runs across Facebook, Instagram, Messenger and Threads, isolated to that ONE advertiser (filters out the stray pages a name search pulls in; echoes resolvedPage to verify). Returns the full ad creative (headline, body copy, CTA + destination link, image and video URLs), run dates, and platform mix. No Meta login. Competitor ad intelligence for AI agents.","service_name":"ApiToll Facebook Advertiser Ads","declared_category":null,"declared_tags":["facebook-ads","ad-library","competitor-intelligence","brand-ads","ad-creative"],"route_template":null,"registry_updated":"2026-08-30T15:50:50.317Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"facebook advertiser","category":"identity","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":2,"unique_payers_30d":2,"last_called_at":"2026-08-30T15:50:49.795Z"},"validation":{"latest":{"observed_at":"2026-09-15T06:37:29.204Z","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-15T06:37:29.204Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T06:06:09.589Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T05:57:56.137Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T08:15:13.974Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T12:43:43.603Z","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","competitor-intelligence","brand-ads","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-08-30T15:50:49.795Z","l30DaysTotalCalls":2,"l30DaysUniquePayers":2},"resource":"https://ads.apitoll.cloud/v1/ads/facebook/advertiser","extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"country":"US","advertiser":"Nike"}},"output":{"type":"json","example":{"ads":[{"title":"Just Do It","pageId":"15087023444","country":"US","ctaText":"Shop Now","ctaType":"SHOP_NOW","linkUrl":"https://www.nike.com/launch","bodyText":"Gear up for your next run. New arrivals now live.","isActive":true,"pageName":"Nike","imageUrls":["https://scontent.xx.fbcdn.net/v/nike1.jpg"],"scrapedAt":"2026-06-25T14:32:09Z","sourceUrl":"https://www.facebook.com/ads/library/?q=Nike&search_type=keyword_unordered&country=US","startDate":1718000000,"adArchiveId":"9876543210987654","daysRunning":14,"linkUrlType":"destination","displayFormat":"VIDEO","templatedText":false,"mediaExpiresAt":"2026-06-29T22:19:28Z","publisherPlatform":["FACEBOOK","INSTAGRAM"]}],"asOf":"2026-06-25T14:32:10Z","count":12,"query":{"advertiser":"Nike"},"source":{"via":"Apify","name":"Facebook Ad Library"},"country":"US","resolvedPage":{"pageId":"15087023444","pageName":"Nike"}}}},"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":["advertiser"],"properties":{"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."},"advertiser":{"type":"string","description":"Brand / advertiser NAME (e.g. Nike, Spotify, Samsung). Resolves to the dominant matching Facebook page. Defaults to a demo brand if omitted."},"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 the 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"},"imageUrls":{"type":"array","items":{"type":"string"}},"scrapedAt":{"type":"string"},"sourceUrl":{"type":"string"},"startDate":{"type":"number"},"adArchiveId":{"type":"string"},"daysRunning":{"type":"number"},"linkUrlType":{"type":"string"},"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":{"advertiser":{"type":"string"}}},"source":{"type":"object","properties":{"via":{"type":"string"},"name":{"type":"string"}}},"country":{"type":"string"},"resolvedPage":{"type":"object","properties":{"pageId":{"type":"string"},"pageName":{"type":"string"}}}}}}}}}}},"description":"Facebook ads from a specific advertiser by brand name — every live and recent ad a brand runs across Facebook, Instagram, Messenger and Threads, isolated to that ONE advertiser (filters out the stray pages a name search pulls in; echoes resolvedPage to verify). Returns the full ad creative (headline, body copy, CTA + destination link, image and video URLs), run dates, and platform mix. No Meta login. Competitor ad intelligence for AI agents.","lastUpdated":"2026-08-30T15:50:50.317Z","serviceName":"ApiToll Facebook Advertiser Ads","x402Version":2}]}}