META AD LIBRARY API

Meta Ad Library Advertiser Search API

Find advertisers in the Meta Ad Library by brand or page name. Each result includes the Page ID to search the advertiser’s ads with, the page’s name, username, category, likes, verification and country, and its linked Instagram account. Returns up to 15 advertisers; this list is not paginated.

Endpoint
POST /meta-ads/search-companies
Price
1 credit per request
SDK
client.metaAds.searchCompanies()
MCP tool
meta_ads_search_companies
Terminal
curl -X POST "https://api.bridgly.app/meta-ads/search-companies" \
-H "Authorization: Bearer $BRIDGLY_KEY" \
-H "Content-Type: application/json" \
-d '{
"q": "nike"
}'
[ REQUEST AND RESPONSE ]

What does the Meta Ad Library Advertiser Search API return?

Find advertisers in the Meta Ad Library by brand name and get their Page ID, category, likes, verification and Instagram account as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

qstringrequired
Name of the brand or advertiser to look for, e.g. "nike".
countrystring · default ALL
Two-letter country code to favor advertisers from, e.g. "US", or "ALL". Defaults to "ALL".
cacheMaxAgeHoursinteger
Accept a cached result scraped up to this many hours ago. A cached result costs no credits, and its `cachedAt` says when it was scraped. When no cached result is that recent, the data is scraped live at the normal price. Leave it out to always scrape live, e.g. 24.
cacheOnlyboolean
Return only a cached result and never scrape live. With `cacheMaxAgeHours`, only a result that recent is returned; without it, the latest cached result of any age. Responds 404, at no cost, when there is none, e.g. true.

Example response

200 OK · application/json
{
"timeMs": 1840,
"creditsCost": 1,
"cachedAt": "2026-01-15T09:30:00.000Z",
"data": {
"companies": [
{
"id": "string",
"name": "string",
"username": "string",
"profilePictureUrl": "string",
"likes": 0,
"category": "string",
"isVerified": true,
"instagramUsername": "string",
"instagramFollowers": 0,
"instagramVerified": true,
"isDeleted": true,
"country": "string"
}
]
}
}
[ USE CASES ]

What can you build with the Meta Ad Library Advertiser Search API?

Find a brand’s pages

List every Facebook page a brand advertises from.

Start a competitor watch

Get the Page IDs to track a competitor’s ads.

Size up advertisers

Compare likes and Instagram followers across pages.

[ FAQ ]

Meta Ad Library Advertiser Search API questions

How do I find a company’s Facebook Page ID for the Ad Library?

Search the brand’s name. Each advertiser comes back with its Page ID, which you can use to search its ads or fetch the advertiser’s details.

How do I use the Meta Ad Library Advertiser Search API?

Send a POST request to https://api.bridgly.app/meta-ads/search-companies with q in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.metaAds.searchCompanies(). AI agents connected to Bridgly over MCP can call the meta_ads_search_companies tool.

How much does the Meta Ad Library Advertiser Search API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.67 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

Try the Meta Ad Library Advertiser Search API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI
free credits

On business email signup. No credit card required.

Start free with 100 credits