gtm.devdocs
research

Company research API

research_company

5 credits / call

Build a structured research brief for one company: what they do, recent signals (funding, launches, hiring, expansion), concrete outreach hooks, likely pain points, and sources. Combines the company graph — including current hiring activity and advertising footprint — with live web research. Optionally steer it with a focus (e.g. "why would they buy sales tooling").

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

Parameters

paramtypedescription
company requiredstringThe company to research: org_id (from resolve_company), domain, or company name.
focusstringOptional angle for the brief, e.g. "why would they buy sales tooling".

Call it from your agent (MCP)

Connect once and research_company 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":"research_company","arguments":{"company":"rippling.com","focus":"why would they buy sales tooling"}}}'

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

Call it over REST

curl -X POST https://api.gtm.dev/v1/tools/research_company \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"rippling.com","focus":"why would they buy sales tooling"}'

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