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
curl -X POST "https://api.bridgly.app/meta-ads/search-companies" \ -H "Authorization: Bearer $BRIDGLY_KEY" \ -H "Content-Type: application/json" \ -d '{ "q": "nike"}'import osimport requestsresponse = requests.post( "https://api.bridgly.app/meta-ads/search-companies", headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"}, json={ "q": "nike", },)data = response.json()const response = await fetch("https://api.bridgly.app/meta-ads/search-companies", { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIDGLY_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "q": "nike" }),});const data = await response.json();import { Bridgly } from "@bridgly/sdk";const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });const res = await client.metaAds.searchCompanies({ q: "nike"});if (res.type === "success") { console.log(res.data);}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
{ "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" } ] }}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.
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.
More Meta Ad Library endpoints
The same API key works on every endpoint. See all Meta Ad Library API endpoints.
- Meta Ad Library Advertiser API→Get a Meta Ad Library advertiser by Page ID: page, Instagram account, ad count, confirmed owner, page history and political ad spend as JSON.
- Meta Ad Library API→Meta Ad Library API: search ads running on Facebook and Instagram by keyword, advertiser, country, status and media type, as structured JSON.
- Meta Ad Details API→Meta Ad Library details API: get one Facebook or Instagram ad by its Library ID, with creative, run dates, payer, reach and audience demographics.
Try the Meta Ad Library Advertiser Search API
100 free credits on business email, no card. Your first call takes a minute.