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
https://api.scrapeadlibrary.com/v1/pages/searchcurl "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
| Field | Type | Description |
|---|---|---|
| id | string | The page ID, for /v1/pages/{page_id} and /v1/pages/{page_id}/ads. |
| name | string | null | The page name. |
| categories | string[] | The page categories. |
| like_count | integer | null | Facebook likes of the page. |
| ads_in_results | integer | How many of the ads matching the keyword this page ran. |
| is_person | boolean | True for person profiles: then no picture is returned. |
Parameters
| Parameter | In | Type | Default | Description |
|---|---|---|---|---|
| q | query | string | required | Keyword (1-100 characters) |
| country | query | string | ALL | ISO 3166 alpha-2 country code or ALL |
| limit | query | integer | 10 | Advertisers 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
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.
Related APIs
- Facebook Ads Search APISearch the Ad Library by keyword or advertiser, with country, platform, media and date filters.
- Facebook Ad Details APIOne ad with its creatives, payers and EU (DSA) reach by country, age and gender.
- Facebook Page Ads APIThe profile of an advertiser page and every ad it runs, page by page.
- Free Ad Library searchTry the data in the browser: a few free searches a day, no account.
Every parameter and error code is in the advertiser search reference.
Find the advertisers of any niche
Create a free account and search the first keyword of your market. 100 free credits every month.