gtm.devdocs
resolve & enrich

Job title normalization API

normalize_title

0.1 credits / call

Normalize a free-text job title ("sdr", "head of eng", "vp sales") into canonical title strings plus a seniority and function guess. Titles resolve against the live title vocabulary (abbreviation-aware, typo-tolerant) layered over a curated shorthand map. Seniority values: owner, cxo, vp, director, manager, senior, entry, training. Functions follow LinkedIn's function vocabulary (sales, marketing, engineering, ...).

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

Parameters

paramtypedescription
title requiredstringJob title text to normalize, e.g. "sdr", "head of eng", "growth marketer".

Call it from your agent (MCP)

Connect once and normalize_title 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":"normalize_title","arguments":{"title":"head of eng"}}}'

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

Call it over REST

curl -X POST https://api.gtm.dev/v1/tools/normalize_title \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"head of eng"}'

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

Related tools