Google ads API
Google 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/google/ads/count" \
-G -d "domain=qonto.com" \
-H "Authorization: Bearer emk_live_…"
{
"platform": "google",
"count": { "kind": "range",
"min": 100, "max": 200 }
}
Google ads API
Live Google counts, on demand.
Ad counts per domain
The live count for any domain on the Google Ads Transparency Center — exact, or a range when Google reports one.
GET /v1/google/ads/countPending checks are free
A count that needs a fresh check answers 202 with retryAfterSeconds. Repeat the call; only a ready count costs a credit, zero included.
202 · Retry-AfterOn demand
Collect any domain on demand
Start a collection for a domain or a Google advertiser ID — up to 500 ads, optionally with details. Status and result pages are free; results stay readable for 7 days.
POST /v1/google/ads/collections
2 credits per 25 ads collected, ×3 with ad details: reserved for maxAds, settled on the ads returned. Empty or failed collections cost nothing.
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 →