{"uid":"cap_Z1buiPFCT5ktHdSKnQh3s","slug":"facebook-advertiser-ad-library-by-brand-name-32caef14","name":"Facebook Advertiser Ad Library by Brand Name","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.","url":"https://ads.apitoll.cloud/v1/ads/facebook/advertiser?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gVoXmi9a1TVnvSEjzuylc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches all live and recent Facebook/Instagram/Messenger/Threads ads from a specific brand advertiser, resolved by name, with full creative details and no Meta login required.","exampleAgentPrompt":"Pull all active Facebook and Instagram ads that Nike is running in the US right now — I want up to 30 results sorted by most recent, including their headlines, body copy, images, and destination links.","exampleUseCases":null,"resultDescription":"Returns a list of ads for the resolved brand page including: full creative text (headline, body, CTA), destination URL, image and video URLs, ad run dates, active/inactive status, platform distribution (Facebook, Instagram, Messenger, Threads), and optionally the resolved advertiser page identity (verified status, categories, profile pic).","failureModes":["Brand name cannot be resolved to a dominant Facebook page — returns empty or ambiguous match","Advertiser has no ads in the requested period or country — returns empty list","Meta Ad Library rate limits or access restrictions cause partial or failed results","Invalid country code or unsupported enum value returns a 400 validation error","Payment of 0.03 USDC not fulfilled via x402 — returns 402 Payment Required","limit exceeds maximum of 60 — returns validation error"],"whenToPreferThis":"Use this endpoint when you know the brand name of a specific advertiser and want all their ads isolated to that one brand (not keyword search noise). Prefer over the keyword search sibling when you want brand-specific ad intelligence rather than topic-based discovery. Prefer over the page-ID-based sibling when you only have the brand name, not the Facebook page ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:36:08.280Z","isFirstParty":false,"canonicalSlug":"facebook-advertiser-ad-library-by-brand-name-32caef14"}