Work / Meta Ad Library ScraperGraphQL / Python / MCP

Public ads.
Read straight
from GraphQL.

Meta’s Ad Library is open to anyone, but the data behind it comes through an internal GraphQL interface. I read that interface directly: no login, no API key, any country.

This run: 48 ads in 5 requests and 13 seconds, with no proxy and no API key.

How I read it.

MetaAdsCollector · meta-ads-collector 1.7.0
cursor → next page JSON JSONL CSV Page ID or keyword country · active or ended GraphQL query 30 ads per call one query at a time One record per ad id · page · start · stop platforms · format · creatives Kept once new ads flagged Export The same collector, three ways in CLI Python API MCP server for AI assistants JSON JSONL CSV Page ID or keyword country · active or ended GraphQL query 30 ads per call, one at a time cursor → next page One record per ad id · page · start · stop platforms · format · creatives Kept once new ads flagged Export The same collector, three ways in CLI Python API MCP server for AI assistants

Nike’s ads, as recorded.

Nike’s public ads in the Meta Ad Library

Recorded real run · 30 October 2026 · Nike’s public ads, US, active

Provenance note in the data file:
Real public ads from the Meta Ad Library, collected by the author with his own tool, no login, no API key. Not live; status and dates are as of the run date.

Recorded, not live: I collected these ads on 30 October 2026 and kept them exactly as the collector returned them, so you can see what one run gives you.

Creatives are shown as text only. I left out image and video URLs because Meta’s signed URLs expire; each ad links to its own Ad Library page instead.

Still running means the ad’s stop date is on or after the run date, 30 October 2026; ended means it is before. Meta marked all 48 ads active at collection.

Loading the recorded run…

Loading the recorded run…

    What I asked for.

    These are the actor’s real input fields. I made this recorded run with the pip library meta-ads-collector 1.7.0, the same collector behind the actor, so the last column shows the equivalent values I used: page Nike, country US, active ads, 48 results.

    • modeKeyword search, an advertiser audit by Page ID, or the same keyword swept across many countries.This run: advertiser, the equivalent of a page search
    • queriesOne or more keywords for keyword search and multi-country sweeps.This run: not set
    • pageIdsFacebook Page IDs to audit in advertiser mode.This run: 15087023444 (Nike)
    • countriesTwo-letter country codes, or ALL for every country. The one required field.This run: US
    • activeStatusActive ads only, ended ads only, or all.This run: active
    • adTypeEvery ad, or only Meta’s regulated categories (political and issue, employment, housing, credit), which carry spend and impressions disclosure.This run: not set
    • mediaTypeAll media, image, video or meme.This run: not set
    • publisherPlatformsFacebook, Instagram, Messenger or Audience Network; empty means all.This run: not set
    • contentLanguagesLanguage codes of the ad copy; empty means all.This run: not set
    • maxAdsPerQueryA cap for each keyword, country and filter combination; the actor pages until it is reached or Meta has no more.This run: 48
    • pageSizeAds asked for per GraphQL call; 30 matches the Ad Library’s own interface.This run: not set
    • proxyConfigurationNeeded for cloud runs, because Meta rate-limits datacenter IPs.This run: none; I ran it locally
    • maxConcurrencyKept for backward compatibility with no effect: queries run one at a time, because Meta’s endpoint rate-limits concurrent traffic.This run: not set

    Run it yourself.

    Two routes to the same collector: the hosted actor, or the open-source package on your own machine.

    On the Apify Store

    Keyword search, advertiser audits and multi-country sweeps, with no setup. Pay per event.

    22 users · Apify Store figures, 30 Oct 2026

    Meta Ad Library Scraper on the Apify Store

    As a Python package

    The CLI, the Python API, and an MCP server so an AI assistant can query the Ad Library for you. No Meta API key.

    MetaAdsCollector on GitHub

    What this page does not show