# Geocoding and maps from one file, at the edge.

> geolith is a geocoding API built on OpenStreetMap and Overture Maps: search, autocomplete, reverse geocoding, place lookup and vector tiles from https://api.geolith.app, served worldwide on Cloudflare’s edge from one static .glx file of 678,043,458 places. In the India benchmark its first result was right for 95.0% of addresses and 95.0% of places. The Free plan includes 100,000 requests a month, and you may store every result.

## Endpoints

- `GET /v1/search`: Address, place or POI name to coordinates
- `GET /v1/autocomplete`: Suggestions while the user types
- `GET /v1/search/structured`: Split address fields to coordinates
- `GET /v1/reverse`: Coordinates to the nearest address
- `GET /v1/nearby`: Places around a point
- `GET /v1/place`: Places by gid
- `GET /v1/tiles/{set}/{z}/{x}/{y}.mvt`: Vector tiles for MapLibre

## Why geolith

- **One file, no database.** The whole index is one static .glx file read with HTTP range reads. No Elasticsearch, no PostGIS, no import that takes a day.
- **Open data you can keep.** OpenStreetMap plus Overture Maps. Store results permanently on every plan, with one attribution line.
- **Bills you can predict.** Flat monthly plans from $0 to $299. Over quota, requests stop with HTTP 429; there is no overage charge.
- **Measured, not claimed.** Benchmarked against Nominatim, Photon and Pelias on the same data, with the method published.

## Benchmark

India, top-1 accuracy (%), 200 queries per set, all four engines in Docker on the same data (20 Oct 2026). Method: https://docs.geolith.app/search/benchmarks/engines

| Set | geolith | Nominatim | Photon | Pelias |
| --- | --- | --- | --- | --- |
| OSM places | 95.0 | 85.0 | 80.5 | 77.0 |
| OSM addresses | 95.0 | 50.5 | 88.5 | 61.5 |
| OSM POIs | 84.5 | 68.5 | 85.5 | 61.0 |
| Overture POIs | 93.0 | 6.0 | 12.5 | 7.0 |
| Autocomplete | 82.5 | n/a | 42.5 | 32.5 |
| Near a point | 96.0 | 44.5 | 52.0 | 39.0 |
| Reverse | 99.5 | 100.0 | 98.5 | 98.0 |

## Pricing

- Free: $0/month for 100,000 requests
- Starter: $19/month for 1,000,000 requests
- Growth: $99/month for 7,500,000 requests
- Scale: $299/month for 25,000,000 requests

## Questions

### What is geolith?

geolith is a geocoding and vector tile API built on OpenStreetMap and Overture Maps. It answers from one static .glx file and runs on Cloudflare’s edge as geolith cloud at https://api.geolith.app.

### How do I call the API?

Sign up at console.geolith.app, create a key, then call GET https://api.geolith.app/v1/search?text=YOUR_QUERY with the key as ?api_key= or an Authorization: Bearer header. The answer is a GeoJSON FeatureCollection.

### Is there a free plan?

Yes. The Free plan includes 100,000 requests a month, with commercial use allowed if you show the OpenStreetMap and Overture attribution.

### Which areas are covered?

Worldwide. The hosted API answers from the planet file: 31.63 GB, 678,043,458 places from OpenStreetMap and Overture Maps. It passed 21 of 21 world test queries, including the Eiffel Tower, 東京タワー and मुंबई.

### Can I store the results?

Yes, permanently, on every plan. Google restricts caching and Mapbox charges more for its Permanent Geocoding API.

Get a free API key: https://console.geolith.app/signup