Authentication
All API requests require authentication via an API key. Include your key in the X-Api-Key header with every request.
Base URL
https://api.geohunter.ai/apiRequest Headers
http
GET /api/sessions HTTP/1.1
Host: api.geohunter.ai
X-Api-Key: gh_your_api_key_here
Content-Type: application/jsonGetting Your API Key
- 1Sign in to your GeoHunter account (Pro or Enterprise plan required)
- 2Go to Account → API Keys → Create New Key
- 3Copy your key immediately — it's only shown once
Rate Limits
| Plan | Requests/min | Searches/month | API Calls/month |
|---|---|---|---|
| Pro | 300 | 2,000 | 100,000 |
| Enterprise | 1,000 | 10,000 | 1,000,000 |
Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Error Responses
All errors return a JSON object with a detail field:
json
{
"detail": "Authentication required"
}| Status | Meaning |
|---|---|
| 401 | Invalid or missing API key |
| 403 | API key lacks required scope |
| 429 | Rate limit exceeded (check Retry-After header) |
| 400 | Invalid request parameters |