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/count

Pending 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-After

On 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 jobCreditsWith the 50 free

Look up a company

LinkedIn totals plus stored Google and Meta counts

Credits1With the 50 free50 companies

Count a company’s Google or Meta ads

Checked on demand; free while pending

Credits1With the 50 free50 counts

Read 100 stored LinkedIn ads

Copy, format, run dates. ×2 with impressions and targeting

Credits4With the 50 free12 pages of 100

Collect 100 Meta or Google ads

Any domain. Pick the period, countries and placements

Credits8With the 50 free6 collections

Collect 500 ads with full details

Impressions, regions, targeting and EU audience data, by network

Credits120With the 50 freeBeyond the free 50

MCP server

Your agent, connected in a minute.

  1. Create a free key

    Sign up, open API keys, copy it once.

  2. Paste the config

    Pick your client. The key goes in the header.

  3. Ask

    “How many ads does sage.com run on LinkedIn, Google and Meta?”

.mcp.json

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 →