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.

LinkedIn

Every ad with copy, format, run dates, impressions, target countries and languages. Live ads or full history.

From our library

/v1/linkedin/ads

Meta

Active-ad count for any company’s Facebook page, across all countries.

Checked on demand

/v1/meta/ads/count

Google

Ad count for any domain on the Google Ads Transparency Center.

Checked on demand

/v1/google/ads/count

On demand

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 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 →