CSV2GEO API Documentation

Fast, accurate geocoding API powered by 504M+ addresses and 72M+ places across 63 countries — 56 endpoints in total.

Geocoding

GET /api/v1/geocode — Convert addresses to coordinates (forward geocoding)
POST /api/v1/geocode — Batch forward geocoding
GET /api/v1/reverse — Convert coordinates to addresses
POST /api/v1/reverse — Batch reverse geocoding
GET /api/v1/autocomplete — Address autocomplete (type-ahead)

Address Tools

GET /api/v1/validate — Check whether an address resolves to a real location
POST /api/v1/validate — Batch validate addresses
GET /api/v1/parse — Parse a free-form address into components
POST /api/v1/parse — Batch parse addresses
GET /api/v1/standardize — Normalize an address into canonical form
POST /api/v1/addresses/compare — Compare two addresses for similarity
GET /api/v1/addresses/nearby — Find addresses within radius of a coordinate
GET /api/v1/addresses/street — List addresses on a given street + postcode
GET /api/v1/addresses/random — Random sample of addresses (testing)
GET /api/v1/addresses/stats — Address-database statistics
GET /api/v1/addresses/interpolate — Interpolate a coordinate from address-range data
GET /api/v1/addresses/crossstreet — Find the cross-street nearest to a coordinate

Places (POIs)

GET /api/v1/places — Search 72M+ places by name
GET /api/v1/places/nearby — Find places near a coordinate
GET /api/v1/places/by-id/{id} — Get place details by ID
Plus /categories, /brands, /chain, /count, /similar, /random, /stats, /batch (POST)

Administrative Boundaries

GET /api/v1/divisions — Search administrative boundaries by name
GET /api/v1/divisions/contains — Find what division contains a point
GET /api/v1/divisions/by-postcode — Postcode → polygon + bbox + population in one call
GET /api/v1/divisions/by-id/{id} — Get division by ID
GET /api/v1/divisions/ancestors/{id} — Walk-up "part-of" chain to country
GET /api/v1/divisions/children/{id} — Walk-down: immediate sub-divisions
GET /api/v1/divisions/consolidated/{id} — Consolidated cities (e.g. NYC = 5 boroughs)
GET /api/v1/divisions/hierarchy/{id} — Full hierarchy tree from a node
GET /api/v1/divisions/subtypes — List division subtypes (locality, county, region, etc.)
GET /api/v1/divisions/countries — List countries with division data
GET /api/v1/divisions/random — Random sample divisions
GET /api/v1/divisions/stats — Division-database statistics

Every division-emitting endpoint also returns a rank.importance field — a 0–1 popularity score derived from Wikidata sitelink count (1.02M divisions ranked; NYC, Paris, Tokyo ≈ 1.0; small rural divisions ~0.2).

IP Geolocation

GET /api/v1/ip — IP → country, region, city, county, ASN
GET /api/v1/ip/me — Geolocate the requester's own IP
POST /api/v1/ip/batch — Batch IP lookup (up to 1,000)

Routing & Navigation (Pro+ only)

GET /api/v1/routing — Turn-by-turn routing through 2-25 waypoints (5 modes: drive / truck / walk / bike / motorcycle)
GET /api/v1/isoline — Reachability polygon (isochrone) for time or distance
POST /api/v1/route-matrix — N×M distance + duration matrix (up to 10,000 cells)
POST /api/v1/map-match — Snap a GPS trace (2-1,000 points) to the road network
GET /api/v1/optimize_route — TSP-style stop ordering (up to 20 waypoints)
GET /api/v1/locate — Snap a single point to the nearest road; returns way_id, road class, surface, speed limit
GET /api/v1/elevation — Per-point elevation lookup (up to 500 points)

Coverage & Account

GET /api/v1/coverage — Per-country boundary tier + counts
GET /api/v1/coverage-stats — Aggregate dataset stats (no API key required)
GET /api/v1/me — Account info, plan, rate limits

Utilities

GET /api/v1/timezone — IANA timezone for a coordinate
GET /api/v1/distance — Haversine distance between two coordinates

Enable JavaScript to view the full interactive API documentation with code examples and try-it-out functionality.

Geocoding API | Places API | Boundaries API