Public API Overview

What the Public API is

The Public API lets you pull your own Huntd data — the companies, people and sources we track on your behalf. It is synchronous, paginated, date-filterable, and consumes no credits.

Base URL

All Public API requests go to:

https://app.gethuntd.com/api/v1/public

Available endpoints

Endpoint	Method	Description
`/sources`	GET	Sources tracked for your organization, with counts
`/people`	GET	Tracked people, paginated
`/companies`	GET	Tracked companies, paginated
`/people/stream`	GET	Every matching person as NDJSON, one request
`/companies/stream`	GET	Every matching company as NDJSON, one request
`/verify`	POST	Check one email address against up to 20 products (Agency plan)
`/verify/{job_id}`	GET	Get the answers for an email check (Agency plan)

Every endpoint has a page in the API Reference tab with a live playground, request and response examples, and every parameter and field.

The /verify endpoints belong to the Agency plan and the row endpoints above belong to the enterprise plan. A key can call one set or the other, never both. See the Email Check API reference.

Your first request

curl 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 body = await response.json();

import os
import requests

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

Next steps

Authentication

Create a key in Settings and make your first authenticated call

Conventions

Envelope, pagination, date filters, rate limits and errors

Streaming

Export the full result set in a single request

Signup webhooks

Get notified when someone at a tracked account signs up

​What the Public API is

​Base URL

​Available endpoints

​Your first request

​Next steps

Authentication

Conventions

Streaming

Signup webhooks

What the Public API is

Base URL

Available endpoints

Your first request

Next steps