Meta Ad Library Advertiser API
Get an advertiser from the Meta Ad Library by its Facebook Page ID: the page and its linked Instagram account, its About text, how many ads it has, the organization Meta confirmed owns it, when it was created or renamed, where the people managing it are, and for advertisers of ads about social issues, elections or politics, their spend and targeting over the last 30 days.
- Endpoint
- POST /meta-ads/get-company
- Price
- 1 credit per request
- SDK
- client.metaAds.getCompany()
- MCP tool
- meta_ads_get_company
curl -X POST "https://api.bridgly.app/meta-ads/get-company" \ -H "Authorization: Bearer $BRIDGLY_KEY" \ -H "Content-Type: application/json" \ -d '{ "pageId": "15087023444"}'import osimport requestsresponse = requests.post( "https://api.bridgly.app/meta-ads/get-company", headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"}, json={ "pageId": "15087023444", },)data = response.json()const response = await fetch("https://api.bridgly.app/meta-ads/get-company", { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIDGLY_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "pageId": "15087023444" }),});const data = await response.json();import { Bridgly } from "@bridgly/sdk";const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });const res = await client.metaAds.getCompany({ pageId: "15087023444"});if (res.type === "success") { console.log(res.data);}What does the Meta Ad Library Advertiser API return?
Get a Meta Ad Library advertiser by Page ID: page, Instagram account, ad count, confirmed owner, page history and political ad spend as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.
Request body
pageIdstringrequired- Facebook Page ID of the advertiser, e.g. "15087023444", as returned in `page.id` or by the advertiser search. The Ad Library link of the advertiser’s ads (`?view_all_page_id=<id>`) works too.
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": { "id": "string", "name": "string", "username": "string", "url": "string", "profilePictureUrl": "string", "likes": 0, "category": "string", "isVerified": true, "instagramUsername": "string", "instagramFollowers": 0, "instagramVerified": true, "isDeleted": true, "about": "string", "adCount": 0, "owner": { "name": "string", "phone": "string", "city": "string", "state": "string", "postalCode": "string", "country": "string" }, "history": [ { "type": "string", "date": "string" } ], "adminCountries": [ { "country": "string", "count": 0 } ], "politicalAds": { "periodEnd": "string", "adCount": 0, "totalSpend": "string", "currency": "string", "targeting": [ { "dimension": "string", "value": "string", "type": "string", "excluded": true, "adCount": 0, "spendShare": 0 } ] } }}What can you build with the Meta Ad Library Advertiser API?
Vet an advertiser
See who owns a page and where it is managed from.
Track political spend
Follow what political advertisers spend and target.
Profile competitors
Get a competitor’s page, Instagram and ad count at once.
Meta Ad Library Advertiser API questions
Can I see who is behind a Facebook advertiser?
Yes, when Meta has confirmed it. The response includes the organization that owns the page with its address and phone number, when the page was created or renamed, and the countries the people managing it are in.
Can I see how much a political advertiser spends?
For advertisers of ads about social issues, elections or politics, the response includes their spend and number of ads over the last 30 days and how those ads were targeted by age, gender, location and audience type.
How do I use the Meta Ad Library Advertiser API?
Send a POST request to https://api.bridgly.app/meta-ads/get-company with pageId in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.metaAds.getCompany(). AI agents connected to Bridgly over MCP can call the meta_ads_get_company tool.
How much does the Meta Ad Library Advertiser 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 Search API→Find advertisers in the Meta Ad Library by brand name and get their Page ID, category, likes, verification and Instagram account 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 API
100 free credits on business email, no card. Your first call takes a minute.