List sources

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

Returns every source tracked for your organization. Not paginated. It accepts the date parameters, which scope the counts.

Request

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

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

import os
import requests

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

Response

{
  "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
    }
  ]
}

Fields

string

Your organization’s domain.

object

Organization-wide totals for the requested date window.

Show properties

integer

Total people checked.

integer

Total companies checked.

array

One entry per tracked source.

Show properties

string

The slug to pass as ?source= on other endpoints.

string

Human-readable name, suitable for display.

string

user — verified per person. company — verified only at account level.

integer

People checked against this source.

integer

Of those checked, how many are confirmed users.

integer

Companies with at least one confirmed user of this source.

boolean

When true, the source is paused and all of its counts read 0.

people counts everyone we checked; users counts the subset who are confirmed users. The gap between them is expected, not an error.

Scoping counts by date

# Counts covering only the last 30 UTC days
curl "https://app.gethuntd.com/api/v1/public/sources?discovered_days=30" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

Errors

Requesting a source your organization is not entitled to returns 403:

{
  "success": false,
  "error": {
    "code": "SOURCE_NOT_ALLOWED",
    "message": "Your organization is not entitled to this source."
  }
}

See the full error table.

Getting started

Public API

Company Lookup

Overview

List sources

Request

Response

Fields

Scoping counts by date

Errors

​Request

​Response

​Fields

​Scoping counts by date

​Errors

Request

Response

Fields

Scoping counts by date

Errors