Facebook Advertiser Search API

Find the advertisers behind the ads of the Meta Ad Library. Send a keyword and a country and get the Facebook pages that ran matching ads, with their page ID, categories, likes and how many of the matching ads each one ran.

Use it to discover competitors in a niche, to build lists of active advertisers, or simply to turn a brand name into the page ID that the other endpoints take.

No credit card needed. One API key works on every endpoint.

Quick example

GEThttps://api.scrapeadlibrary.com/v1/pages/search
curl "https://api.scrapeadlibrary.com/v1/pages/search?q=running%20shoes&country=US&limit=10" \
  -H "X-API-Key: sal_your_api_key"
{
  "data": [
    {
      "id": "15087023444",
      "name": "Nike",
      "is_person": false,
      "profile_picture_url": "https://scontent.xx.fbcdn.net/...",
      "categories": ["Sportswear Store"],
      "like_count": 39000000,
      "ads_in_results": 4
    }
  ],
  "credits_used": 1,
  "cached": false
}

Illustrative values: a real response carries the live data of the ads and advertisers you ask for.

Fields of each advertiser

FieldTypeDescription
idstringThe page ID, for /v1/pages/{page_id} and /v1/pages/{page_id}/ads.
namestring | nullThe page name.
categoriesstring[]The page categories.
like_countinteger | nullFacebook likes of the page.
ads_in_resultsintegerHow many of the ads matching the keyword this page ran.
is_personbooleanTrue for person profiles: then no picture is returned.

Parameters

ParameterInTypeDefaultDescription
qquerystringrequiredKeyword (1-100 characters)
countryquerystringALLISO 3166 alpha-2 country code or ALL
limitqueryinteger10Advertisers to return, 1-30

Pair it with the page ads endpoint: search with q, keep the id of the advertiser you want, then list its ads.

What people build with it

Competitor discovery

Find every brand that advertises on “protein bars” or “solar panels” in a country, including the ones you did not know about.

Lead generation

Agencies and SaaS tools build lists of companies that actively spend on Meta ads in a niche.

Name to page ID

Turn a brand name into the page ID you need for the page ads and page profile endpoints.

Market mapping

Compare how many advertisers compete on a keyword in each country before entering a market.

Pricing

An advertiser search costs 1 credit per 10 advertisers returned, rounded up. Empty results and errors are free.

  • 100 free credits every month, no credit card
  • Then $1 per 1,000 credits, pay as you go
  • Only successful calls are billed: errors cost nothing
  • Credits never expire; bulk packs from 10,000 credits for $9

See all prices and bulk packs →

Also in the MCP server for AI assistants

The ScrapeAdLibrary MCP server gives Claude, Cursor and other MCP clients the same data as tools: search_pages. Ask “who advertises meal kits in Germany?” and the assistant returns the advertisers with their page IDs.

Run it with uvx scrapeadlibrary-mcp and your API key in SCRAPEADLIBRARY_API_KEY; the MCP server guide has the configuration for each client. Tool calls are billed like API calls.

Facebook Advertiser Search API: FAQ

How does the advertiser search work?
It searches the ads of the Meta Ad Library for your keyword and returns the pages that ran them, deduplicated, with ads_in_results telling how many of the matching ads each page ran.
Can I search an advertiser by its exact name?
Use the brand name as the keyword and pick the page whose name matches among the results, then pass its ID to GET /v1/pages/{page_id}/ads. The match is on the text of the ads, so resellers and fan pages may appear too.
Does it find advertisers that are not running ads?
No. The Ad Library lists pages through their ads, so an advertiser appears only if it ran ads matching the keyword in the selected country.
How much does it cost?
1 credit per 10 advertisers returned, rounded up: the default 10 results cost 1 credit, an empty result costs nothing.

Find the advertisers of any niche

Create a free account and search the first keyword of your market. 100 free credits every month.