Geocoding & Geo Tools API
FreemiumGeocode cities to coordinates, reverse-geocode coordinates, measure distances and find the time zone of any place.
Documentation
Geocode cities to coordinates, reverse-geocode coordinates, measure distances and find the time zone of any place.
What you get
- Geocoding — every city worldwide with 15,000+ people, to latitude/longitude
- Reverse geocoding — nearest city to any coordinates
- Distance and bearing between two points
- Time zone and current local time for any coordinates
Great for delivery and logistics, store locators, travel apps, analytics and form auto-fill.
Quick start
Subscribe to a plan (the Basic plan is free), then call the API at https://geo-tools.p.apihiver.com with your key in the X-API-Key header:
curl "https://geo-tools.p.apihiver.com/v1/geocode?city=Pune" \
-H "X-API-Key: YOUR_API_KEY"Endpoints
| Method | Path | What it does |
|---|---|---|
GET | /v1/geocode | City name → coordinates |
GET | /v1/reverse | Coordinates → nearest city |
GET | /v1/distance | Distance, bearing and midpoint between two points |
GET | /v1/timezone | Timezone and local time at a point |
Open the Endpoints tab to see every parameter, example request and example response, and to try the API live.
Errors
Every error is JSON with the same shape:
{"error": {"code": "INVALID_INPUT", "message": "city: Field required"}}| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_INPUT | A parameter is missing or has the wrong format — the message says which |
| 401 | UNAUTHORIZED | Missing or invalid X-API-Key |
| 429 | — | Plan quota or rate limit reached (see the X-RateLimit-* headers) |
| 502 / 503 / 504 | — | A data source or the API server is temporarily unavailable — retry after a few seconds |
Data & privacy
Data comes from GeoNames cities (CC BY 4.0) and timezonefinder, computed on our servers.
Geocoding & Geo Tools API FAQ
- Is the Geocoding & Geo Tools API free?
- Yes. The Basic plan is free and includes 500 requests per month — no card needed. Paid plans start at ₹299 per month for 10,000 requests.
- How much does the Geocoding & Geo Tools API cost?
- Basic: free for 500 requests; Pro: ₹299/month for 10,000 requests; Ultra: ₹999/month for 50,000 requests; Mega: ₹2,499/month for 2,00,000 requests. Billing is monthly and you can cancel any time.
- How do I use the Geocoding & Geo Tools API?
- Subscribe to a plan on APIHiver, create an API key in the Console, then send requests to https://geo-tools.p.apihiver.com with your key in the X-API-Key header. You can also try every endpoint in the browser playground first.
- What endpoints does the Geocoding & Geo Tools API have?
- It has 4 endpoints: City name → coordinates (GET /v1/geocode); Coordinates → nearest city (GET /v1/reverse); Distance, bearing and midpoint between two points (GET /v1/distance); Timezone and local time at a point (GET /v1/timezone).
- What are the Geocoding & Geo Tools API rate limits?
- Basic: 2 requests per second; Pro: 5 requests per second; Ultra: 10 requests per second; Mega: 20 requests per second. Monthly quotas depend on the plan; every response includes X-RateLimit headers showing what's left.
- Can I use one API key for the Geocoding & Geo Tools API and other APIs?
- Yes. One APIHiver key works for every API you subscribe to, so you don't need a separate account or key per provider.
Endpoints
4 endpoints — full list is in the sidebar on larger screens.