Facebook Ads Library Scraper v2
Under maintenancePricing
$0.75 / 1,000 ads
Search Meta's Ad Library by keyword, page handle, page URL, or full Ad Library URL. Pay-per-result.
Pricing
$0.75 / 1,000 ads
Rating
0.0
(0)
Developer
Arnas
Maintained by CommunityActor stats
0
Bookmarked
13
Total users
1
Monthly active users
18 hours ago
Last modified
Categories
Share
All notable changes to this actor will be documented in this file.
Default proxy is now RESIDENTIAL (was datacenter). This was the cause of a ~95% failure rate (58 FAILED / 61 runs over the preceding 30 days). useApifyProxy: true with no explicit group resolves to Apify's shared datacenter pool, which Meta blocks on the Ad Library: every bootstrap attempt came back "Meta rate-limit", the run burned all 6 IP rotations and then died on ERR_TUNNEL_CONNECTION_FAILED.
Verified head-to-head on 2026-08-21 with an identical query, changing only the proxy:
| Proxy | Result |
|---|---|
RESIDENTIAL (explicit) | SUCCEEDED — 5/5 ads in 104 s |
| default (datacenter) | FAILED — 0 ads after 375 s |
When the user picks no proxy group we now select RESIDENTIAL (and US, as before). Explicit apifyProxyGroups / apifyProxyCountry are always respected.
Graceful fallback when residential is unavailable. Residential access is plan-gated; if we injected RESIDENTIAL ourselves and the account can't use it, the run falls back to the user's original proxy config with an explanatory warning instead of hard-failing at startup.
Input schema default and README updated so the Console pre-selects residential US, and the no-proxy warning now states plainly that datacenter runs will likely return no ads.
Proxy defaulting extracted into src/proxy.ts as a pure function with 7 unit tests (70 tests total).
page.mouse.wheel() (which fired at default mouse position (0,0), not over Meta's virtualized scroll container) plus a 3-iteration stable-count early-exit. The result was a hard cap at ~30 ads per query regardless of maxAdsPerQuery. The new path opens one Playwright page per query, intercepts the first /api/graphql/ request to harvest lsd / fb_dtsg / doc_id / cookies, closes the browser, and walks AdLibrarySearchPaginationQuery over HTTP using got-scraping until has_next_page === false or the user-supplied cap is reached. maxAdsPerQuery: 500 now actually returns up to 500 ads for high-volume advertisers.doc_id sniffed at bootstrap, not hardcoded. Meta rotates query identifiers on every build; we read whatever is current from the live request rather than embedding a value that goes stale.forwardCursor / cursor treated as opaque. The captured variables object is reused verbatim with only the cursor key mutated per page.nextPageCursor surfaced on the final dataset row when the run was stopped by maxAdsPerQuery (or maxAds) before the connection ended. Opaque resume token; absent when pagination ran to completion.extractAdObjects(), findJsonObjectEnd(), scrapeRenderedAds(), MAX_SCROLLS_PER_SOURCE, SCROLL_WAIT_MILLIS — DOM HTML-grep and scroll-loop helpers no longer needed.test/url.test.ts), token extraction (test/token-extraction.test.ts), paginator cursor loop / retry / dedup / schema drift (test/paginator.test.ts), and runner orchestration (test/runner.test.ts). Live Meta calls remain a manual smoke test via apify run.query as the headline input — accepts keywords (crochet), page handles (@ZapierApp), page URLs, or full Ad Library URLs.country, activeStatus, adType, mediaType, period, sortBy, maxAds, maxAdsPerQuery. The old scrapePageAds.*, urls, count, and limitPerSource keys are still accepted for backwards compatibility.mediaType and adType filters that map to Ad Library URL parameters.period filter now applies to keyword searches too (not only page-ad scrapes).query field so multi-search runs can be split apart later.curious_coder/facebook-ads-library-scraper.