Integrator quickstart

This is the path if you are wiring FreshTalent into Claude, Cursor, or an ATS / CRM / outreach tool. Recruiters stay in the dashboard quickstart.

Dashboard names vs identifiers

Dashboard	REST	MCP
Search	`GET /people`	`search`
Companies	`GET /companies`	`expand`
Lists	`/lists`	`collect`
Targets	`/targets`	`watch`
Monitoring	`GET /events`	`events`
Settings → Notifications	`/signals/preferences`	`subscribe`

Get an API key

In the dashboard under API Keys, create a key. It is shown once.

Keep keys server-side. Never ship ft_live_… in a browser app or a public repo.

Run one search

Same query the recruiter typed, as compact JSON:

curl \
  --get "https://api.freshtalent.ai/v1/people" \
  --data-urlencode "nl=ex-palantir FDEs, left 18mo" \
  --data-urlencode "view=compact" \
  -H "Authorization: Bearer $FRESHTALENT_API_KEY"

The response is { data, query, meta }. data is compact people. query is the structured filter that actually ran: save it for repeat people searches, or add data to a List. Target discovery uses a different schema and is not an exact replay of the graph search. See Search query compatibility.

Pick a surface

Surface	Use it when
Claude / Cursor / VS Code	An agent should run Search → Lists → Targets → Monitoring
REST	Your app, ATS sync, outreach sequencer

Push movement into the ATS

Poll GET /events?since=24h. Each row is one profile diff (Left company, Open to work, …) with the person slug and LinkedIn URL. Upsert by URL into Greenhouse, Ashby, Lever, HubSpot, or your sequencer.Full recipe: ATS, CRM, and outreach.

Copy-paste: Node

const params = new URLSearchParams({
  nl: "ex-palantir FDEs, left 18mo",
  view: "compact",
});

const res = await fetch(
  `https://api.freshtalent.ai/v1/people?${params}`,
  { headers: { Authorization: `Bearer ${process.env.FRESHTALENT_API_KEY}` } },
);

if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const { data, query, meta } = await res.json();
console.log(meta.count, "matches");
console.log("echoed query", query);

For a complete script with list creation, search results, checkpoints, and HTTP error handling, follow Build your first integration.

Claude, Cursor, VS Code

Eight tools over https://api.freshtalent.ai/mcp. Host configs and a prompt that actually works.

ATS & CRM

Poll events, map stages, keep the CRM as source of outreach truth.

API reference

Playground for every public endpoint.

Auth, errors, limits

Keys, 401s, 300 req/min, Target slots.

Start here

The product

Connect

Reference

Integrator quickstart

Dashboard names vs identifiers

Copy-paste: Node

Next

Claude, Cursor, VS Code

ATS & CRM

API reference

Auth, errors, limits

​Dashboard names vs identifiers

​Copy-paste: Node

​Next

Claude, Cursor, VS Code

ATS & CRM

API reference

Auth, errors, limits

Dashboard names vs identifiers

Copy-paste: Node

Next