On demand · REST and MCP
The ad library API.
LinkedIn, Meta and Google ads for any company, in one schema. Use our library, or check a company on demand.
$ curl "https://adsrunning.com/v1/advertisers" \
-G -d "domain=qonto.com" \
-H "Authorization: Bearer emk_live_…"
"platforms": {
"linkedin": { "total": 184, "live": 22 },
"google": { "count": { "kind": "range",
"min": 100, "max": 200 } },
"meta": { "count": { "kind": "exact",
"count": 12 } }
}
Coverage
Three networks, one schema.
Every ad with copy, format, run dates, impressions, target countries and languages. Live ads or full history.
From our library
/v1/linkedin/ads
Active-ad count for any company’s Facebook page, across all countries.
Checked on demand
/v1/meta/ads/count
Ad count for any domain on the Google Ads Transparency Center.
Checked on demand
/v1/google/ads/count
Collect up to 500 LinkedIn, Google or Meta ads for any company on demand. Results stay readable for 7 days; status and result pages are free.
Live, on demand
POST /v1/linkedin/ads/collectionsPOST /v1/google/ads/collectionsPOST /v1/meta/ads/collections
Credits
What a job costs.
Every response shows the credits charged and your balance. Collections reserve credits up front and refund what they don’t return.
50 free
with your first key. No card, no plan needed.
| The job | Credits | With the 50 free |
|---|---|---|
Look up a companyLinkedIn totals plus stored Google and Meta counts | Credits1 | With the 50 free50 companies |
Count a company’s Google or Meta adsChecked on demand; free while pending | Credits1 | With the 50 free50 counts |
Read 100 stored LinkedIn adsCopy, format, run dates. ×2 with impressions and targeting | Credits4 | With the 50 free12 pages of 100 |
Collect 100 Meta or Google adsAny domain. Pick the period, countries and placements | Credits8 | With the 50 free6 collections |
Collect 500 ads with full detailsImpressions, regions, targeting and EU audience data, by network | Credits120 | With the 50 freeBeyond the free 50 |
MCP server
Your agent, connected in a minute.
Create a free key
Sign up, open API keys, copy it once.
Paste the config
Pick your client. The key goes in the header.
Ask
“How many ads does sage.com run on LinkedIn, Google and Meta?”
Create the file in your project if needed. Set ADSRUNNING_API_KEY in your shell.
{
"mcpServers": {
"adsrunning": {
"type": "http",
"url": "https://adsrunning.com/mcp",
"headers": {
"Authorization": "Bearer ${ADSRUNNING_API_KEY}"
}
}
}
}8 tools: look up companies, count and list ads, collect up to 500 LinkedIn, Google or Meta ads. Full guide →