Skip to main content

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.

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.

​
1. Get your API Key

Contact your organization administrator to get an API key. Keys follow this format: 
hntd_{id}_{secret}
Keep your API key secret. Never expose it in client-side code.

​
2. Submit a Company Lookup

Look up contacts at any company by domain: 
curl -X POST https://api.gethuntd.com/api/v1/external/company-lookup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey" \
  -d '{"domain": "example.com"}'
You’ll receive a job ID immediately: 
{
  "success": true,
  "data": {
    "job_id": "job_1705596234567_a1b2c3d4",
    "domain": "example.com",
    "sources": ["source_name"],
    "scheduled_for": "immediate"
  }
}

​
3. Get Results

Poll for results using the job ID: 
curl -X GET "https://api.gethuntd.com/api/v1/external/company-lookup/job_1705596234567_a1b2c3d4/result" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"
When complete, you’ll get the contacts: 
{
  "job_id": "job_1705596234567_a1b2c3d4",
  "domain": "example.com",
  "source": "source_name",
  "status": "success",
  "contacts": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "job_title": "Senior Software Engineer",
      "linkedin_url": "https://linkedin.com/in/johndoe",
      "company": "Example Corp",
      "company_domain": "example.com",
      "verifications": [
        {
          "source": "source_name",
          "isVerified": true
        }
      ]
    }
  ],
  "credits_used": 1,
  "created_at": "2024-01-18T12:30:00.000Z"
}
Instead of polling, you can provide a webhook_url when submitting the lookup to receive results automatically.

​
Example with Webhook

curl -X POST https://api.gethuntd.com/api/v1/external/company-lookup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey" \
  -d '{
    "domain": "example.com",
    "webhook_url": "https://yourapp.com/webhooks/huntd"
  }'

​
Next Steps

API Reference

Full API documentation

Webhooks

Set up webhook callbacks