Meta (Facebook) Ad Library Scraper — Premium

Apify actor: [Add your published Store URL]

Collect public ads from the Meta Ad Library (Facebook / Instagram ecosystem) into Apify Dataset rows plus a structured OUTPUT — ideal for competitive intelligence, creative research, and transparency reporting. You drive the run with a keyword, a Page ID, or a full Ad Library URL, plus max results and optional sort order.

At a glance

This actor scrapes Meta Ad Library search results. Input rule: provide exactly one of keyword, pageId, or adLibraryUrl, plus maxResults. Optional sortBy: total_impressions or most_recent. The scraper builds or normalizes the Ad Library URL, fetches ads, and writes per-ad records to the Dataset (nested objects such as metadata, ad_content, timing, performance, distribution, status) and a summary in OUTPUT. Availability and fields depend on what Meta exposes for each ad. Not affiliated with Meta; use per Meta’s terms and applicable laws.

Best for: brands monitoring competitors, agencies auditing creatives, and researchers studying advertising transparency data.

---

Highlights

Benefit	Detail
Flexible entry	Keyword search, numeric Page ID, or paste the exact Ad Library URL you already use in the browser.
Sort control	Match Meta-style ordering via sortBy (impressions vs recent-style grouping).
Rich records	Structured blocks per ad: copy, media hints, timing, spend/impression ranges where shown, platforms, status flags.
Apify-native	Standard Dataset export (JSON / CSV / Excel) plus OUTPUT for run-level summary.

---

Features

Area	What you get
Search modes	Keyword (keyword_unordered URL), page (view_all_page_id), or custom URL with your own filters (country, active_status, media_type, …).
Volume	maxResults — scrapes until target or no more ads (see run logs if truncated).
Data shape	Nested JSON per ad (see Output below).
Validation	Clear errors for invalid pageId (non-numeric) or non–Ad-Library URLs.

---

Input

Where: Apify → Input tab.

Field	Required	Description
One of: keyword · pageId · adLibraryUrl	Yes (pick one)	Keyword = brand/term search · pageId = numeric Facebook Page ID · adLibraryUrl = full facebook.com/ads/library or meta.com/ads/library URL.
maxResults	Yes	How many ads to collect (minimum 1).
sortBy	No	total_impressions (default) or most_recent — see actor schema for behavior notes.

---

Output

Location	Contents
Dataset	One item per ad with structured fields (e.g. metadata, ad_content, timing, performance, distribution, status, additional_info — exact keys depend on parser version).
OUTPUT	Run summary: totals, timing, search metadata, aggregated stats where computed, and embedded or referenced full payload depending on size.

Preview a finished run’s Dataset in Apify to see the live field list for your configuration.

---

Quick start

1. Open Input.
2. Enter either a keyword (e.g. nike), or a page ID, or paste an Ad Library URL from your browser.
3. Set maxResults.
4. Optionally change sortBy.
5. Start → export Dataset as CSV/JSON.

---

Example inputs (JSON)

Keyword

{
  "keyword": "nike",
  "maxResults": 100,
  "sortBy": "total_impressions"
}

Page ID

{
  "pageId": "15087023444",
  "maxResults": 50
}

Full URL (custom filters)

{
  "adLibraryUrl": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=coffee&search_type=keyword_unordered",
  "maxResults": 200
}

---

FAQ

Is this a Meta API product?
No. It automates public Ad Library experiences. Layouts and fields can change.

Why fewer ads than maxResults?
The page may have no more matching ads, or filters (country, status, media type) may limit visibility.

Can I search Instagram-only here?
This actor is centered on Ad Library URLs (often cross‑surface). For Instagram-only workflows, see the dedicated Instagram Ad Scraper actor in this workspace if you publish both.

Legal
Comply with Meta’s terms, election/ad policies where relevant, and data protection rules. Do not use for non‑public or unauthorized data.

---

Technical notes

• Language: Python (see Dockerfile / src/main.py).
• Run: Apify mainFile → src/main.py.
• Support: Use Apify run logs and Dataset preview for debugging.

---

Discoverability & related topics

Meta Ad Library scraper Apify · Facebook ads transparency · competitive ad intelligence · brand creative monitoring · Ad Library keyword search export · page ID ad export · political ads research tooling · Apify Dataset ad archive.

---

FastAd — automation & growth tooling.