{"uid":"cap_y3jRK1wYeu_Ag_pxqRDzu","slug":"facebook-ads-scraper-x402-436671d7","name":"Facebook Ads Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/facebook-ads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"type":"string","default":"ALL","description":"Country code such as US or GB, or ALL. Used only when the URL has no country parameter."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Maximum ads across every URL. Set 0 for no overall cap."},"startUrls":{"type":"array","description":"Public Facebook page URLs, Ad Library search URLs, page-filter URLs, or individual ad URLs. Search URLs preserve their country, media, platform, and other URL filters."},"activeStatus":{"enum":["all","active","inactive"],"type":"string","default":"all","description":"Used when the URL has no active_status parameter. An existing URL setting takes priority."},"resultsLimit":{"type":"integer","default":30,"maximum":30,"minimum":1,"description":"Maximum ads to save for each URL. The public page currently exposes at most 30 without authenticated pagination."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"adUrl":null,"pageId":null,"pageUrl":null,"inputUrl":null,"pageName":null,"adArchiveId":null,"pageCategories":null,"pageProfilePictureUrl":null}],"product":"facebook-ads"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lBjnEhrrJ90cR9VQa9PAO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured ad data from Facebook's Ad Library for given page URLs or Ad Library search URLs, returning up to 30 ads per URL.","exampleAgentPrompt":"Pull the latest 30 active Facebook ads from Nike's public page (https://www.facebook.com/nike) in the US and give me the structured ad data including page info and archive IDs.","exampleUseCases":[{"title":"Competitor ad monitoring for a brand","prompt":"Grab all currently active Facebook ads from Apple's page at https://www.facebook.com/apple — limit to 30 ads for the US market — so I can see what they're currently promoting."},{"title":"Ad Library research for agency client","prompt":"Scrape Facebook Ad Library search results from this URL https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=GB&q=nike for up to 30 ads and return the structured data including page names and ad archive IDs."},{"title":"Multi-brand ad landscape analysis","prompt":"Fetch the Facebook ads for these three brand pages — https://www.facebook.com/cocacola, https://www.facebook.com/pepsi, https://www.facebook.com/redbull — up to 10 ads each, all statuses, for the US, so I can compare what each is running."}],"resultDescription":"Returns a JSON object with a count of ads found, a product identifier ('facebook-ads'), and an array of ad items each containing: adUrl, pageId, pageUrl, inputUrl, pageName, adArchiveId, pageCategories, and pageProfilePictureUrl. Fields may be null if not available from the public Ad Library.","failureModes":["Empty result (no ads found) — not charged; returns count: 0 and empty items array","Invalid or private Facebook page URL — may return empty or null fields","Rate limiting or Facebook blocking — scraper may return fewer results than requested","resultsLimit capped at 30 — public Ad Library does not expose more without authenticated pagination","Incorrect country code — falls back to ALL if unrecognized","URL with conflicting filters — URL parameters take priority over API-level country/activeStatus settings"],"whenToPreferThis":"Choose this endpoint when you need structured, pay-per-result Facebook Ad Library data without managing scrapers or browser automation yourself. It's ideal for competitive ad intelligence, agency research, and market analysis workflows where you want clean JSON output from public Facebook pages or Ad Library search URLs. Failed or empty runs are not billed, making it low-risk for exploratory queries. Prefer alternatives if you need authenticated pagination beyond 30 ads per page or private/unpublished ad data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:55:24.878Z","isFirstParty":false,"canonicalSlug":"facebook-ads-scraper-x402-436671d7"}