← API Catalog
Apify·Async

Facebook Ads Library Scraper (Meta Ads) [Reach Included]

Social$0.00045 / result

What it does

Facebook & Meta Ads Library Scraper — search the Meta Ad Library by keyword or page URL and export every ad: creatives, copy, spend & impressions, EU reach & transparency, advertiser pages, run dates. Richest schema on the Store. Filter by country, status & media type. Free trial.

Returns: Facebook & Meta Ads Library Scraper — search the Meta Ad Library by keyword or page URL and export every ad: creatives, copy, spend & impressions, EU reach & transparency, advertiser pages, run dates. Richest schema on the Store. Filter by country, status & media type. Free trial.

Parameters

ParameterTypeRequiredDescription
debugbooleanNoIf enabled, the actor will output detailed debug logs including proxy info, session details, response headers, and content structure analysis. Useful for troubleshooting.
proxyjsonNoLeave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies.
adTypeselectNoFilter by ad category. All ads covers every commercial ad. The special categories (Political & issue, Housing, Employment, Credit) are the regulated transparency categories — these carry impression/reach data.
sortByselectNoHow to order the ads returned. Default keeps Facebook's own ranking. Most impressions first sorts by total impressions (works best for Facebook Page ad searches / EU-transparency ads; commercial ads without impression data may be unaffected).
maxDelaynumberNoMaximum delay to wait before calling the new items from API
maxItemsnumberNoMaximum number of items that will be scraped per crawl. Example: 50. Default 10000. On a free Apify plan a run is capped at 30 ads and to ONE search target — the first start URL, search-term/country pair or advertiser the input builds, whichever comes first — so a free run with 2 terms x 2 countries returns only the first combination. Paying Apify accounts remove both caps.
minDelaynumberNoMinimum delay to wait before calling the new items from API.
dateRangeselectNoOnly ads that started in this window. Applied to keyword search, pasted Ad Library URLs, and page searches — unless startDateMin / startDateMax are set, which win. Leave empty to skip.
mediaTypeselectNoFilter ads by creative media type.
startUrlsarrayNoPaste full Meta Ad Library URLs (with any filters), a single-ad link (https://www.facebook.com/ads/library/?id=123…), or Facebook Page URLs. This is the most powerful mode — it supports every Ad Library filter (country, media type, status, keyword/phrase, date range, political/housing/employment categories, publisher platform, language). Example: https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&is_targeted_country=false&media_type=all&q=nike&search_type=keyword_unordered — or a page URL like https://www.facebook.com/Nike. Typed a plain term or brand here instead (Netflix, Netflix.com)? It is searched as a keyword, the same as if you had put it in Search terms below.
categoriesarrayNoYou can add one more categories to filter ads by their categories like: brand, etc. Write one category per input/line.
newAdsOnlybooleanNoWhen enabled, ads already stored on the Watchlist ID are left out of the dataset and not charged. The search itself still runs in full. Requires watchlistId. Default: false.
searchModeselectNoBroad matches any of the words; Exact phrase matches the words together (auto-wrapped in quotes).
advertisersarrayNoScrape every ad from specific advertisers. Enter one or more Facebook Page IDs (the numeric id, e.g. 103582046420186), or paste an Ad Library page URL that contains view_all_page_id=…. Each advertiser's ads are returned in full. Works on its own or alongside the URL and keyword inputs. Country follows the Countries filter below (or worldwide if unset).
searchTermsarrayNoKeywords or brand names to look up in the Meta Ad Library — e.g. nike, weight loss, black friday. Each term is searched separately. Leave empty if you're pasting URLs above. The fields below apply to these search terms.
watchlistIdtextNoNamed key-value store that remembers which ads (by ad_archive_id) this run already delivered. Use the same id on a schedule (for example nike-daily) and later runs leave them out, so a monitored advertiser or keyword bills only the ads that are new. Type any short name — it is folded into the form the platform stores (meta_us_massage_gun is kept as meta-us-massage-gun).
enrichEmailsbooleanNoWhen on, each advertiser's own website (the one the ad itself links to) is scraped for a contact address, and the row gains contactEmail, contactWebsite and emailEnrichment. One lookup per advertiser, not per ad - a search that returns twenty ads from one company is looked up and billed once. Advertisers with no site of their own, and lookups that find nothing, are free. Off by default.
startDateMaxtextNoOnly include ads that started running on or before this date. Format YYYY-MM-DD. Leave empty to skip.
startDateMintextNoOnly include ads that started running on or after this date. Format YYYY-MM-DD. Leave empty to skip.
adActiveStatusselectNoFilter by whether ads are currently running.
includeAdReachbooleanNoInclude Ad Reach and EU transparency in output.
maxConcurrencynumberNoMaximum number of pages that can be processed at the same time.
minConcurrencynumberNoMinimum number of pages that will be processed at the same time.
searchCountriesarrayNoTwo-letter country codes (US, GB, DE …) or ALL for worldwide. Each country is queried separately per search term. Defaults to US.
contentLanguagesarrayNoOnly return ads whose creative is in these languages. Use ISO 639-1 two-letter codes (en, es, de …). Leave empty for all languages.
transcribeVideosbooleanNoWhen on, each ad that has a video is transcribed via the Video & Audio Transcriber and the row gains transcript, transcriptLanguage and hookSpoken (the first 3 seconds of speech). Image-only ads are saved as usual with no transcription charge. Off by default — existing scrape-only runs are unchanged. Billed by the transcriber at $0.05 per started minute of audio (up to 3 minutes per video, about $0.05 for a typical ad); failed videos are free. Pair with mediaType = video.
maxRequestRetriesnumberNoNumber of times the crawler will retry a failed request before giving up.
publisherPlatformsarrayNoOnly return ads shown on these platforms. Valid values: facebook, instagram, messenger, audience_network. Leave empty for all platforms.
includeTotalActiveAdsbooleanNoInclude total active ads count per page in output.
filterDuplicatePageIdsbooleanNoIf enabled, only one ad per unique page_id will be kept (first occurrence). This removes duplicate ads from the same page.

Endpoints

GET/v1/agents/resources/inspect/apify.memo23.facebook-ads-library-scraper-cheerioPublic
POST/v1/agents/resources/estimate/apify.memo23.facebook-ads-library-scraper-cheerioPublic
POST/v1/agents/resources/run/apify.memo23.facebook-ads-library-scraper-cheerioAgent key
GET/v1/agents/resources/runs/{run_id}Agent key

Quick start

Run it with one Deva Agent Key over the OpenAI-compatible resource rail.

curl -X POST https://api.deva.me/v1/agents/resources/run/apify.memo23.facebook-ads-library-scraper-cheerio \
  -H "Authorization: Bearer deva_your_key_here" \
  -H "Content-Type: application/json" \
  --data '{
    "params": {}
  }'

Related in Social

Instagram Scraper
Extract Instagram posts, reels, profiles, places, hashtags, carousels, and comments. Get data from Instagram using one or more Instagram URLs or search queries: content, context, metrics, metadata. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.
Tweet Scraper V2 - X Scraper / Twitter Scraper / X.com Scraper
Lightning-fast search, URL, list, and profile scraping, with customizable filters. At $0.40 per 1000 tweets, and 30-80 tweets per second, it is ideal for researchers, entrepreneurs, and businesses! Get comprehensive insights from Twitter (X) now!
Instagram Post Scraper
Scrape Instagram posts. Just add one or more Instagram usernames and get your data in seconds including caption, metrics, images, mentions, coauthors, recent comments, sponsored status, video duration, views. Export scraped data, schedule scraper via API, integrate with other tools or AI workflows.
Facebook Posts Scraper
Extract posts, videos, and engagement metrics from Facebook pages. Get text captions, reactions, video transcripts, images, external links, collaborators, and more from Facebook pages and profiles. Export ad data, schedule runs via API, and integrate with other tools or AI workflows.
LinkedIn Profile Scraper + Email (No Cookies)
Extract detailed information from LinkedIn profiles in bulk, including complete work experience, education history, skills and more. No cookies or account required.
TikTok Data Extractor
Extract data about videos, users, and channels based on hashtags or scrape full user profiles including posts, total likes, name, nickname, numbers of comments, shares, followers, following, and more.