{"uid":"cap_ZIH03Dk5oWF2-JVb5SKEk","slug":"apify-facebook-ads-scraper-via-stableapify-0a70530c","name":"Apify Facebook Ads Scraper (via StableApify)","description":"Search Apify Store actors, start actor runs, and fetch results over x402 and MPP.","url":"https://stableapify.dev/api/actors/apify/facebook-ads-scraper/call","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","required":["startUrls","activeStatus"],"properties":{"onlyTotal":{"type":"boolean","description":"If checked, you will scrape only the total count of ads. The output will be saved as a single dataset item per page."},"startUrls":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"method":{"type":"string"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"payload":{"type":"string"},"userData":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"description":"Add a URL of a Facebook Page or brand URL from Meta Ad Library. You can add multiple URLs using the Bulk edit option."},"activeStatus":{"enum":["","active","inactive"],"type":"string","default":"","description":"Select active status for ads"},"resultsLimit":{"type":"integer","maximum":9007199254740991,"minimum":1,"description":"⚠️ If you leave this field empty, you will get as many results as possible."},"isDetailsPerAd":{"type":"boolean","description":"If checked, you will scrape extra audience details scraped for each ad."},"includeAboutPage":{"type":"boolean","description":"If checked, the scraper will extract the about page information for all unique pages or urls."}},"description":"Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).","additionalProperties":{}},"options":{"type":"object","properties":{"build":{"type":"string","maxLength":100,"minLength":1},"memory":{"type":"integer","maximum":32768,"minimum":128},"maxItems":{"type":"integer","maximum":100000,"minimum":1}},"description":"Optional Apify run options.","additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fmP43c3_OilqV3juaNhJb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes Facebook/Meta Ad Library ads for given page or brand URLs, returning structured ad data including active/inactive status, audience details, and page info.","exampleAgentPrompt":"Can you scrape all active Facebook ads from Coca-Cola's Meta Ad Library page at https://www.facebook.com/ads/library/?id=cocacola and give me the audience details for each ad, up to 500 results?","exampleUseCases":[{"title":"Competitor ad intelligence research","prompt":"Pull all currently active ads from Nike's Facebook page in the Meta Ad Library — I want audience details for each ad and a cap of 200 results."},{"title":"Brand ad volume audit","prompt":"I just need the total count of ads running for this brand on Meta Ad Library, no full details needed — check https://www.facebook.com/ads/library/?id=somecompany with active status only."},{"title":"Inactive ad archive collection","prompt":"Scrape both active and inactive Facebook ads from Apple's Meta Ad Library page and also include their about page info, limit to 1000 ads."}],"resultDescription":"A dataset of structured Facebook ad records including ad creative details, active/inactive status, optional per-ad audience targeting information, and optional advertiser about-page data. If onlyTotal is set, returns a single item with the total ad count per page.","failureModes":["Invalid or inaccessible Facebook/Meta Ad Library URL returns an error or empty dataset","Rate limiting or bot detection by Facebook may cause incomplete results","Payment failure (insufficient USDC balance for x402) blocks the call","Actor run timeout if resultsLimit is very large or pages have many ads","Missing required fields (startUrls or activeStatus) causes validation error","Private or removed pages return no results"],"whenToPreferThis":"Choose this endpoint when you need structured Facebook/Meta Ad Library data for one or more brand pages, especially for competitive intelligence, ad monitoring, or marketing research. It is ideal when you want to programmatically access ad creatives, audience details, or historical/inactive ads that are publicly visible on the Meta Ad Library. Prefer this over manual browsing or generic web scrapers because it returns normalized, structured data and supports bulk URL inputs with fine-grained filters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:47:10.133Z","isFirstParty":false}