ToolzerHub
Meta Ad Library scraper API

Meta Ad Library API for every advertiser

Advertiser pages, their live ads and full ad details as JSON, including commercial ads outside the EU. Send a brand name, get the ads back.

  • No card needed
  • Failed calls are free
  • Pack credits never expire
Brand
Endpoint
curl "https://api.toolzerhub.com/v1/meta/search-pages?q=nike&country=US" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
200 OK
Real response, 15 Oct 2026
{
  "data": {
    "items": [
      {
        "pageId": "15087023444",
        "name": "Nike",
        "alias": "nike",
        "category": "Sportswear Store",
        "likes": 39502874,
        "verification": "BLUE_VERIFIED",
        "instagramUsername": "nike",
        "instagramFollowers": 290975744
      },
      {
        "pageId": "51212153078",
        "name": "Nike Football",
        "alias": "nikefootball",
        "category": "Product/service",
        "likes": 39985003,
        "verification": "BLUE_VERIFIED",
        "instagramUsername": "nikefootball",
        "instagramFollowers": 44771145
      },
      {
        "pageId": "65604112975",
        "name": "Nike Run Club",
        "alias": "nikerunning",
        "category": "Sports & Recreation Venue",
        "likes": 15259395,
        "verification": "BLUE_VERIFIED",
        "instagramUsername": "nikerunning",
        "instagramFollowers": 6224835
      }
    ]
  }
}

3 of 15 pages; profile picture URLs removed.

1K+
Meta Ad Library calls served
99.3%
finished without a server error
1.5 s
median response time
8
Meta Ad Library endpoints

From our request logs.

Endpoints

What you can get

One request each, 1 credit per call. Open one to see its parameters and a real response.

See all 8 Meta Ad Library endpoints in the docs(opens in new tab)

Response

What comes back

Field names and types read off the real responses in the demo above.

  • Search advertisers/v1/meta/search-pages8 fields
    • pageIdstring"15087023444"
    • namestring"Nike"
    • aliasstring"nike"
    • categorystring"Sportswear Store"
    • likesnumber39,502,874
    • verificationstring"BLUE_VERIFIED"
    • instagramUsernamestring"nike"
    • instagramFollowersnumber290,975,744
  • Page ads/v1/meta/page8 fields
    • ad_archive_idstring"1107386451952079"
    • page_idstring"15087023444"
    • page_namestring"Nike"
    • is_activebooleantrue
    • start_datenumber1,788,246,000
    • end_datenumber1,791,961,200
    • publisher_platformarray[2 items]
    • snapshotobject{ display_format, cta_text }
  • Ad details/v1/meta/ad-details1 fields
    • advertiserobject{ page_info, page_spend }

Use cases

What people build with it

  • 01Spy on competitor ad creativePage adsAd details
  • 02Find a brand's advertiser pageSearch advertisersPage ads
  • 03See which ads are live nowPage adsSearch ads
  • 04Research ads for a keywordSearch adsAd details
  • 05Compare advertisers' reachSearch advertisersAd details

How it works

From key to JSON

  1. 01x-api-key••••••••••Get a key100 free credits a month, no card
  2. 02GET/v1/meta/search-pagesSend a requestAny HTTP client, no SDK needed
  3. 03{ data, status }200Get JSONFailed calls cost nothing

Pricing

What it costs

Every endpoint on this page costs 1 credit per call. Failed calls cost nothing.

  • Free$0every month
    • 100 credits a month
    • No card needed
  • 10K pack$19one time
    • 10,000 credits
    • Never expire
    • $1.90 per 1,000
  • Starter$29a month
    • 20,000 credits a month
    • Cancel anytime
    • $1.45 per 1,000

Per 1,000 credits

  • 10K pack$1.90
  • Starter$1.45
  • Growth$1.32
  • Scale$1.21
  • Business$0.99
  • Customfrom $0.99

Plans renew monthly and cancel anytime. Custom plans start at 1M+ credits. Full pricing

Connect on RapidAPIBilling through RapidAPI? Subscribe to our Meta-Facebook Ad Library Scraper API there, or see all our listings.

Compare

Why not build it yourself

Three ways to get Meta Ad Library data into your app.

CompareToolzer HubOfficial Ad Library APIYour own scraper
SetupOne API keyMeta app, ID check, 60-day tokensProxies, sessions, retries
When Meta Ad Library changesWe fix itMeta keeps it workingYou fix the parser
Cost to start100 free credits a monthFree, political ads only outside the EUProxies and your time

Official API access rules: Meta: ads_archive reference (opens in new tab)

Want to try it yourself first? Our free facebook-ad-library-scraper on GitHub covers ads, advertisers, ad details.

FAQ

Questions

Is this the official Meta Ad Library API?
No. Toolzer Hub is not affiliated with Meta Platforms. Outside the EU, commercial ads are not returned by the official endpoint. They are visible on the public Ad Library site, which is what we read.
What does the official Meta Ad Library API allow?
Ads that did not reach any location in the EU are returned only if they are about social issues, elections or politics.
What data does it return?
Search advertisers, Page ads, Ad details, Search ads, as JSON.
What does it cost?
1 credit per call. New workspaces get 100 credits a month at no cost; plans work out to $0.99 to $1.45 per 1,000 credits. Failed calls are not charged.

Guides

Meta Ad Library guides

Tested walkthroughs with real requests and output.

Try the Meta Ad Library API free

Every new workspace gets 100 credits a month. Buy credits only when you need more.

Not affiliated with Meta Platforms, Inc.

More APIs on the same key