Meta ads API

Meta 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/meta/ads/count" \
    -G -d "domain=qonto.com" \
  -H "Authorization: Bearer emk_live_…"

// excerpt
{
  "platform": "meta",
  "count": { "kind": "exact", "count": 214 },
  "scope": { "activity": "active",
             "countries": "ALL" }
}

Meta ads API

Live Meta counts, on demand.

Active-ad counts per Facebook page

The live active-ad count for any company’s Facebook page, across all countries. Select by domain, or by Facebook page URL or handle.

GET /v1/meta/ads/count

Pending checks are free

A count that needs a fresh check answers 202 with retryAfterSeconds. Repeat the call; pending checks use no capacity.

202 · Retry-After

On demand

Collect any company on demand

Start a collection for a domain, a Facebook page URL or handle, a LinkedIn company ID or a company UUID — up to 500 ads with start and last-shown dates, optionally with Meta’s EU transparency details. Each ad returned is one collected ad; reading the collection pages is free for 7 days.

POST /v1/meta/ads/collections

Each ad returned is one collected ad; reading the collection pages is free. Empty and failed collections use no collected ads. The app, API and MCP share your plan’s limits.

Rate limits

What a job costs.

Every plan gets the full library, the API and MCP. One returned company or ad is one result. Live collections use collected ads instead, and their result pages are free. Pick Free, Starter, Pro or Max on the homepage.

1,000 results

every 5 hours, plus 50 collected ads every week. No card.

The jobResultsCollected ads

Look up a company

LinkedIn totals plus stored Google and Meta counts

Results1Collected ads0

Count a company’s Google or Meta ads

Checked on demand; free while pending

Results1Collected ads0

Read 100 stored LinkedIn ads

Copy, format, run dates, impressions and targeting

Results100Collected ads0

Collect 100 Meta or Google ads

Any domain. Pick the period, countries and placements

Results0Collected ads100

Collect 500 ads with full details

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

Results0Collected ads500

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 →

On 19 Nov 2026, adsrunning’s API provided LinkedIn creatives and LinkedIn, Meta and Google ad counts.