signals

Company ad activity API

company_ad_activity

2.5 credits / company returned

One company's advertising footprint across the public LinkedIn and Meta ad libraries: total/per-platform ad counts and impressions (from the precomputed ad-spend index, falling back to a live tally for companies not yet indexed), the single biggest ad's impression floor and how many ads cleared a high-impression bar, first/last seen dates, and up to 10 recent ads with copy snippets and landing domains. Address the company by org_id (from resolve_company), domain, or name. If total_ads comes back 0, a `note` may explain that our ad index doesn't cover this company's HQ market yet, rather than confirming it doesn't advertise.

Get an API key 1,000 free live credits · no card

Parameters

param	type	description
domain	string	Company website domain, e.g. "stripe.com".
name	string	Company name (exact-ish; use resolve_company first for fuzzy input).
org_id	string	LinkedIn organization id (from resolve_company). Preferred.

Call it from your agent (MCP)

Connect once and company_ad_activity appears in your agent’s toolbox next to every other gtm.dev tool. Claude Code:

claude mcp add --transport http gtm https://mcp.gtm.dev \
  --header "Authorization: Bearer YOUR_API_KEY"

Under the hood, the client sends:

curl -X POST https://mcp.gtm.dev \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"company_ad_activity","arguments":{"domain":"hubspot.com"}}}'

other clients (cursor, claude desktop, openai agents sdk, langchain): mcp setup

Call it over REST

curl -X POST https://api.gtm.dev/v1/tools/company_ad_activity \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"hubspot.com"}'

Errors (401, 402, 429, 400) are listed in the REST reference. Calls that error are not billed — see pricing.

Company ad activity API