> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gethuntd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public API Overview

> Pull the companies, people and sources Huntd tracks for you

## 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`](/public-api/sources) | GET | Sources tracked for your organization, with counts |
| [`/people`](/public-api/people) | GET | Tracked people, paginated |
| [`/companies`](/public-api/companies) | GET | Tracked companies, paginated |
| [`/people/stream`](/public-api/people-stream) | GET | Every matching person as NDJSON, one request |
| [`/companies/stream`](/public-api/companies-stream) | GET | Every matching company as NDJSON, one request |
| [`/verify`](/api-reference/email-check/submit-check) | POST | Check one email address against up to 20 products (Agency plan) |
| [`/verify/{job_id}`](/api-reference/email-check/get-result) | 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.

<Note>
  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](/api-reference/email-check/submit-check).
</Note>

## Your first request

<CodeGroup>
  ```bash cURL theme={null}
  curl https://app.gethuntd.com/api/v1/public/sources \
    -H "X-API-Key: hntd_abc12345_yoursecretkey"
  ```

  ```javascript JavaScript theme={null}
  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();
  ```

  ```python Python theme={null}
  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()
  ```
</CodeGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/public-api/authentication">
    Create a key in Settings and make your first authenticated call
  </Card>

  <Card title="Conventions" icon="book" href="/public-api/conventions">
    Envelope, pagination, date filters, rate limits and errors
  </Card>

  <Card title="Streaming" icon="bolt" href="/public-api/streaming">
    Export the full result set in a single request
  </Card>

  <Card title="Signup webhooks" icon="bell" href="/public-api/signup-webhooks">
    Get notified when someone at a tracked account signs up
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.