Geocoding API docs
Forward and reverse geocoding — convert place names to coordinates and coordinates back to addresses. Includes country, region, timezone and population data.
Authentication
All Geocoding API requests authenticate via two headers. Get your API key from your RapidAPI dashboard after subscribing on the Basic (free) tier or higher.
X-RapidAPI-Key: YOUR_API_KEY X-RapidAPI-Host: geocoding-by-helix-api.p.rapidapi.com
Base URL
https://geocoding-by-helix-api.p.rapidapi.com
Endpoints
GET
/searchForward geocoding — place name to coordinates
GET
/reverseReverse geocoding — coordinates to address
Code Examples
Python
import requests
url = "https://geocoding-by-helix-api.p.rapidapi.com/search"
headers = {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "geocoding-by-helix-api.p.rapidapi.com",
}
response = requests.get(url, headers=headers)
print(response.json())JavaScript
const response = await fetch(
"https://geocoding-by-helix-api.p.rapidapi.com/search",
{
method: "GET",
headers: {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "geocoding-by-helix-api.p.rapidapi.com"
}
}
);
const data = await response.json();cURL
curl -X GET "https://geocoding-by-helix-api.p.rapidapi.com/search" \ -H "X-RapidAPI-Key: YOUR_API_KEY" \ -H "X-RapidAPI-Host: geocoding-by-helix-api.p.rapidapi.com"
Response Format
All endpoints return JSON in this consistent envelope:
{
"status": "ok",
"data": { /* endpoint-specific payload */ },
"meta": {
"cached": false,
"latency_ms": 142,
"request_id": "req_abc123"
},
"timestamp": "2026-05-21T12:00:00Z"
}Error Codes
| HTTP | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST | Missing or invalid parameter |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 403 | FORBIDDEN | Your plan doesn't include this endpoint |
| 429 | RATE_LIMIT_EXCEEDED | Too many requests — back off and retry |
| 500 | INTERNAL_ERROR | Something went wrong on our side |
| 503 | UPSTREAM_UNAVAILABLE | A third-party data source is down |
Common Use Cases
Location autocomplete
Address validation
Mapping apps
Logistics & routing
Store locators