{"slug":"ads-apitoll-cloud-v1-ads-facebook-advertiser-4be45a","title":"Facebook ads from a specific advertiser by brand name — every live and recent ad","host":"ads.apitoll.cloud","method":"GET","resource":"https://ads.apitoll.cloud/v1/ads/facebook/advertiser","category":"image","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","price_listed":0.03,"price_asked":0.03,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":892,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"advertiser":"Nike","country":"US"},"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"},"advertiser":{"description":"Brand / advertiser NAME (e.g. Nike, Spotify, Samsung). Resolves to the dominant matching Facebook page. Defaults to a demo brand if omitted.","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"},"resolve_advertiser":{"description":"Also resolve the 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":["advertiser"],"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"},"publisherPlatform":{"items":{"type":"string"},"type":"array"},"scrapedAt":{"type":"string"},"sourceUrl":{"type":"string"},"startDate":{"type":"number"},"templatedText":{"type":"boolean"},"title":{"type":"string"}},"type":"object"},"type":"array"},"asOf":{"type":"string"},"count":{"type":"number"},"country":{"type":"string"},"query":{"properties":{"advertiser":{"type":"string"}},"type":"object"},"resolvedPage":{"properties":{"pageId":{"type":"string"},"pageName":{"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":892,"error":null}],"description_full":"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.","last_updated":"2026-08-30T15:50:50.317Z","schemes":["exact"]}