META AD LIBRARY API

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
Terminal
curl -X POST "https://api.bridgly.app/meta-ads/get-company" \
-H "Authorization: Bearer $BRIDGLY_KEY" \
-H "Content-Type: application/json" \
-d '{
"pageId": "15087023444"
}'
[ REQUEST AND RESPONSE ]

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

200 OK · application/json
{
"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
}
]
}
}
}
[ USE CASES ]

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.

[ FAQ ]

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.

Try the Meta Ad Library Advertiser 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