Facebook Ads Scraper (ScrapeCreators)

Scrape the Meta (Facebook / Instagram) Ad Library - the public, Meta-operated archive of ads running on Facebook, Instagram, Messenger and Audience Network - through the ScrapeCreators API. One actor, four modes.

What it does

Mode	What you get
search_ads	Ads matching a keyword across every advertiser. Cursor-paginated. Great for competitive/creative research.
company_ads	Every active (or inactive) ad for a specific Facebook page. Cursor-paginated.
search_companies	Company → page_id lookup. Returns name, category, likes, verification, and Instagram handle/followers.
ad_details	Full detail for a single ad, including all creative variants (snapshot.cards), link URL, CTA, and optional video transcript.

Output

Every item is pushed to the default dataset as the raw ScrapeCreators object, with one extra field added by this actor:

{
    "ad_archive_id": "615470338018648",
    "page_id": "115531458627129",
    "page_name": "…",
    "snapshot": { "body": {...}, "images": [...], "videos": [...] },
    // ... all other ScrapeCreators fields ...
    "_meta": {
        "searchMode": "search_ads",
        "query": "running shoes",
        "page": 2,
        "scrapedAt": "2026-04-15T12:00:00.000Z"
    }
}

_meta lets you distinguish rows when one run mixes multiple queries or page IDs.

How to use it

1. Pick a mode from the dropdown (what you want to do).
2. Paste your search terms - one per line. What they mean depends on the mode (see the description under the field).
3. Optionally tweak country, status, or maxItems.
4. Click Start.

Everything else is in the collapsed Advanced section with good defaults.

Example inputs

Find ads by keyword

{
    "searchMode": "search_ads",
    "searchTerms": ["running shoes", "trail runners"],
    "country": "US",
    "maxItems": 500
}

All ads from Nike (brand name, numeric page ID, or both)

{
    "searchMode": "company_ads",
    "searchTerms": ["Nike"],
    "country": "US"
}

Look up a company's page ID

{
    "searchMode": "search_companies",
    "searchTerms": ["nike", "lululemon", "on running"]
}

Single ad with video transcript

{
    "searchMode": "ad_details",
    "searchTerms": ["702369045530963"],
    "getTranscript": true
}

Cost & limits

• The actor itself is a thin wrapper - Apify compute usage is minimal.
• All data is billed by ScrapeCreators, not Apify. The ScrapeCreators API key is bundled with this actor, so you don't need to supply one.
• The search_ads GET endpoint caps at ~1,500 results (cursor-size limit). For wider sweeps, narrow by country, date range, or more specific keywords and run multiple jobs.
• Use maxItems to put a hard ceiling on any single run.

---

⚠️ Disclaimers - please read

Third-party data source. This actor does not scrape Facebook/Instagram directly. It calls ScrapeCreators, an independent third-party API. Data freshness, completeness, uptime, and pricing are governed by ScrapeCreators' own terms of service and infrastructure - not by the author of this actor, not by Apify, and not by Meta.

Public data only. The Meta Ad Library is a public archive published by Meta itself. This actor only exposes ads that are already visible to anyone on facebook.com/ads/library. No login, cookies, or private data are involved.

Not affiliated with Meta. "Facebook", "Instagram", "Meta", and the Meta Ad Library are trademarks and products of Meta Platforms, Inc. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Meta in any way.

Not affiliated with ScrapeCreators. This actor is an independent integration; the author is not affiliated with ScrapeCreators. The ScrapeCreators API key bundled with this actor may be rate-limited, rotated, or revoked at any time without notice. Treat the bundled key as "use at your own risk."

Your responsibility. By running this actor you confirm that:

1. Your use of the scraped data complies with Meta's Terms of Service, the Ad Library terms, ScrapeCreators' terms of service, and all applicable laws in your jurisdiction (including GDPR, CCPA, and similar privacy regulations where relevant).
2. You will not use the data to target, identify, or harass individuals, to train generative models without the appropriate rights, or for any unlawful, deceptive, or harmful purpose.

No warranty. This actor is provided "as is," without warranty of any kind, express or implied. The author and Apify are not liable for any missing data, incorrect data, API outages, policy changes at Meta or ScrapeCreators, unexpected costs, rate-limiting, account suspensions, or any damages arising from its use.

Trademark notice. All trademarks, logos, brand names, and product names referenced in scraped ad creatives are the property of their respective owners. Their appearance in output data does not imply any endorsement or affiliation.

---

Links

• ScrapeCreators API docs: https://docs.scrapecreators.com
• Meta Ad Library: https://www.facebook.com/ads/library
• Source & issues: https://github.com/UnseenUser/meta-ads