Quickstart

This page can be copied as markdown and given as context to any AI coding agent along with your Huntd API key for easy implementation.

This quickstart uses the Huntd Enterprise API. On the Agency plan, start with Submit Email Check instead.

1. Create an API key

In the Huntd dashboard, go to Settings → API & webhooks and create a key. Any member of your organization can create one. Keys look like this:

hntd_{8 hex}_{32 hex}

The key is shown once, so store it straight away, for example in a HUNTD_API_KEY environment variable. Only call the API from your backend, never from a browser.

2. See what Huntd tracks for you

List Sources returns every tool Huntd tracks for your organization. Each source slug is what you filter by in the next step.

curl -X GET "https://app.gethuntd.com/api/v1/public/sources" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const response = await fetch('https://app.gethuntd.com/api/v1/public/sources', {
  headers: { 'X-API-Key': process.env.HUNTD_API_KEY }
});

const { sources } = await response.json();
console.log(sources.map((s) => s.source));

import requests
import os

response = requests.get(
    'https://app.gethuntd.com/api/v1/public/sources',
    headers={'X-API-Key': os.environ['HUNTD_API_KEY']}
)

print([s['source'] for s in response.json()['sources']])

{
  "success": true,
  "organization": "acme.com",
  "totals": { "people": 92070, "companies": 3866 },
  "sources": [
    {
      "source": "devin",
      "label": "Devin",
      "level": "user",
      "people": 95276,
      "users": 2637,
      "userCompanies": 239,
      "maintenance": false
    }
  ]
}

3. Pull the people using a tool

List People returns the people Huntd tracks. source picks the tool and is_user=true keeps confirmed users only.

curl -X GET "https://app.gethuntd.com/api/v1/public/people?source=devin&is_user=true&limit=100" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const params = new URLSearchParams({ source: 'devin', is_user: 'true', limit: '100' });

const response = await fetch(
  `https://app.gethuntd.com/api/v1/public/people?${params}`,
  { headers: { 'X-API-Key': process.env.HUNTD_API_KEY } }
);

const { data } = await response.json();
console.log(data.map((p) => `${p.email} at ${p.companyDomain}`));

import requests
import os

response = requests.get(
    'https://app.gethuntd.com/api/v1/public/people',
    params={'source': 'devin', 'is_user': 'true', 'limit': 100},
    headers={'X-API-Key': os.environ['HUNTD_API_KEY']}
)

for person in response.json()['data']:
    print(person['email'], person['companyDomain'])

{
  "success": true,
  "pagination": { "page": 1, "limit": 100, "total": 842, "totalPages": 9 },
  "data": [
    {
      "id": "62381c7cc5fc496eff56fd60",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "email": "ada@acme.com",
      "jobTitle": "VP Engineering",
      "company": "Acme",
      "companyDomain": "acme.com",
      "sources": ["devin"],
      "discoveredAt": "2026-07-31T17:28:28.725Z"
    }
  ]
}

id is stable across pages and runs, so upsert on it.

4. Keep it in sync

Daily delta: request discovered_days=2 once a day and upsert on id. See incremental sync.
Full backfill: Stream People returns everything in one request, as NDJSON.
Real time: Signup webhooks POST to your endpoint when someone at a tracked account signs up.

Next Steps

API Reference

Every endpoint, with a live playground

Conventions

Pagination, date filters, rate limits and errors

Streaming

Export a full result set in one request

Signup webhooks

Get notified when a tracked account signs up

Getting started

Public API

1. Create an API key

2. See what Huntd tracks for you

3. Pull the people using a tool

4. Keep it in sync

Next Steps

API Reference

Conventions

Streaming

Signup webhooks

​1. Create an API key

​2. See what Huntd tracks for you

​3. Pull the people using a tool

​4. Keep it in sync

​Next Steps

API Reference

Conventions

Streaming

Signup webhooks

1. Create an API key

2. See what Huntd tracks for you

3. Pull the people using a tool

4. Keep it in sync

Next Steps