Skip to main content
The Huntr API is a REST API served from https://api.tryhuntr.com. All request bodies are JSON; all responses are JSON. Authenticated endpoints require an x-api-key header.

​
Base URL

https://api.tryhuntr.com

​
Authentication

Pass your API key on every authenticated request: 
curl https://api.tryhuntr.com/balance \
  -H "x-api-key: hntr_YOUR_KEY"
Get a key from the dashboard or via email verification.

​
Rate limit

5 requests per second per API key on authenticated endpoints. See Rate Limits for headers and retry guidance.

​
Endpoint groups

GroupEndpoints
ResearchPOST /research, GET /research/{requestId}/status
List BuildingPOST /company-search, POST /company-search-count, POST /person-search, POST /person-search-count
Person EnrichmentPOST /person-email, POST /person-linkedin, POST /person-linkedin-url
Company EnrichmentPOST /company-linkedin, POST /company-linkedin-url, POST /company-linkedin-posts, POST /company-tech-stack, POST /company-contact, POST /company-jobs
Social ActivityPOST /linkedin-post, POST /linkedin-post-reactions, POST /linkedin-post-comments
X IntelligencePOST /x-profile, POST /x-post-search, POST /x-post, POST /x-thread
Page EnrichmentPOST /page-find, POST /page-scrape, POST /page-analyze
AccountGET /balance, GET /usage
SystemGET /health

​
Public endpoints

These endpoints work without an API key:
EndpointPurpose
GET /pricingCurrent pricing matrix
GET /healthHealth check

​
Pricing

Every authenticated response includes a price field (USD charged) and most include credits_remaining. Call GET /pricing to fetch the current pricing matrix without auth. 
curl https://api.tryhuntr.com/pricing
See Credits and Pricing for how billing works.