{"uid":"cap_gWYyJMawXM4yJJ0mbAwJt","slug":"apitoll-facebook-ad-library-page-ad-intelligence-9341d533","name":"ApiToll Facebook Ad Library — Page Ad Intelligence","description":"Facebook ads from a specific advertiser page — monitor every live and recent ad a competitor runs by passing their Facebook page URL, vanity handle, or page id. Returns the full ad creative (headline, body copy, CTA + destination link, image and video URLs), run dates, and platform mix across Facebook, Instagram, Messenger and Threads. Track a competitor’s ad strategy and winning creatives over time. No Meta login.","url":"https://ads.apitoll.cloud/v1/ads/facebook/page?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":["page"],"properties":{"page":{"type":"string","description":"Facebook page URL (facebook.com/nike), vanity handle, profile.php?id=, or numeric page id. Defaults to a demo page 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…) 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 the 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"},"pageVerified":{"type":"boolean"},"displayFormat":{"type":"string"},"templatedText":{"type":"boolean"},"mediaExpiresAt":{"type":"string"},"publisherPlatform":{"type":"array","items":{"type":"string"}}}}},"asOf":{"type":"string"},"page":{"type":"string"},"count":{"type":"number"},"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":"{{product.name}}","pageId":"15087023444","country":"US","ctaText":"Shop Now","ctaType":"SHOP_NOW","linkUrl":"https://fb.com/canvas_doc/1357532171781925","bodyText":"{{product.brand}} — {{product.description}}","isActive":true,"pageName":"Nike","imageUrls":["https://scontent.xx.fbcdn.net/v/nike1.jpg"],"scrapedAt":"2026-06-19T14:32:09Z","sourceUrl":"https://www.facebook.com/ads/library/?view_all_page_id=15087023444","startDate":1718000000,"adArchiveId":"9876543210987654","daysRunning":14,"linkUrlType":"canvas","pageVerified":true,"displayFormat":"DCO","templatedText":true,"mediaExpiresAt":"2026-06-29T22:19:28Z","publisherPlatform":["FACEBOOK","INSTAGRAM","AUDIENCE_NETWORK"]}],"asOf":"2026-06-19T14:32:10Z","page":"https://www.facebook.com/nike","count":25,"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":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.00","reviews":1,"stars":null,"state":"rated"},"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_tiF3LtVT4QsoXpcG1vIsb","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":"Scrapes all live and recent ads for a specific Facebook page from the public Facebook Ad Library, returning full creative details, run dates, platform mix, and optionally advertiser identity.","exampleAgentPrompt":"Pull the last 30 days of active ads from Nike's Facebook page (facebook.com/nike) — show me the headline, body copy, CTA, image URLs, and which platforms each ad ran on, sorted by most impressions first, targeting the US market.","exampleUseCases":[{"title":"Monitor competitor ad creative strategy","prompt":"I need to see all the ads that Tesla is currently running on Facebook and Instagram — grab the headlines, body copy, call-to-action buttons, and any image or video URLs, then tell me which platforms each ad is active on and when they started running."},{"title":"Track political advertiser spending and messaging","prompt":"Pull every ad from the Democratic National Committee's Facebook page for the last 90 days — I want to see the ad copy, destination links, which platforms they're using, and roughly how long each ad has been running so I can track their messaging shifts."},{"title":"Research brand's seasonal creative campaigns","prompt":"Get all live ads from Coca-Cola's Facebook page right now and show me the creative assets, headlines, and destination URLs organized by campaign topic — I'm trying to understand what their current promotional themes are across different platforms."}],"resultDescription":"A JSON array of ads for the requested page, each containing: ad archive ID, page name and ID, headline/title, body text, CTA text and type, destination link URL, image/video URLs, display format, publisher platforms, start date, days running, active status, scrape timestamp, and source URL. Also includes metadata: total count, country, timestamp, and optionally resolved advertiser identity (verified status, categories, profile picture).","failureModes":["Page not found or invalid page URL — returns empty ads array or error","Meta Ad Library temporarily unavailable or rate-limited — upstream Apify scraper fails","No ads found for the given filters (period, ad_type, country, platform) — returns empty array","Invalid country code or unsupported enum value — returns validation error","Page has no ads in the Library (new page or no paid promotion) — returns count 0","Payment failure via x402 — call not executed, no data returned"],"whenToPreferThis":"Choose this endpoint when you need to retrieve all ads for a specific, known Facebook advertiser page without requiring a Meta API key or Facebook login. Ideal for competitive ad intelligence, creative research, political ad monitoring, and brand tracking. Prefer over generic web scraping when you need structured ad creative data (copy, CTA, images, platforms, dates) for a specific page. Not suited for broad keyword-based ad searches across all advertisers (use a keyword-search endpoint instead).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-09-16T14:02:52.975Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:35:53.898Z","isFirstParty":false,"canonicalSlug":"apitoll-facebook-ad-library-page-ad-intelligence-9341d533"}