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:
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"}'
{
"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"
{
"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
