Forward & reverse geocoding with 514M+ addresses
Convert any address into precise latitude/longitude coordinates. Supports structured addresses, free-form queries, and partial addresses.
Convert GPS coordinates back into human-readable addresses. Get structured address components or formatted full addresses.
Geocode up to 10,000 addresses in a single API request. Perfect for processing large datasets efficiently.
Verify that addresses are real and deliverable. Get confidence scores and standardized formats.
Type-ahead suggestions for address input. Perfect for forms and search boxes with real-time suggestions.
Break down freeform addresses into structured components: street, city, state, postal code, country.
Complete list of Geocoding API endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/geocode | Forward geocode a single address to coordinates |
| POST | /v1/geocode | Batch geocode multiple addresses (up to 10,000) |
| GET | /v1/reverse | Reverse geocode coordinates to an address |
| POST | /v1/reverse | Batch reverse geocode multiple coordinates |
| GET | /v1/validate | Validate a single address for deliverability |
| POST | /v1/validate | Batch validate multiple addresses |
| GET | /v1/autocomplete | Get address suggestions for type-ahead search |
| GET | /v1/parse | Parse an address into structured components |
| POST | /v1/parse | Batch parse multiple addresses |
| GET | /v1/standardize | Standardize address to postal format |
| GET | /v1/addresses/nearby | Find addresses near a coordinate |
| GET | /v1/addresses/street | Get all addresses on a specific street |
| GET | /v1/addresses/stats | Get address database statistics by country |
| GET | /v1/addresses/random | Get random sample addresses (for testing) |
| GET | /v1/addresses/compare | Check if two addresses are the same location |
| GET | /v1/addresses/interpolate | Estimate coordinates via range interpolation |
| GET | /v1/addresses/crossstreet | Find intersection of two streets |
| GET | /v1/health | API health check and status |
GET /v1/geocode?q=1600+Pennsylvania+Ave,+Washington+DC&country=US&api_key={key}
Response:
{
"results": [{
"lat": 38.8977,
"lng": -77.0365,
"formatted_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA",
"street": "Pennsylvania Avenue NW",
"house_number": "1600",
"city": "Washington",
"state": "DC",
"postal_code": "20500",
"country": "US",
"confidence": 1.0,
"accuracy_type": "rooftop"
}]
}GET /v1/reverse?lat=38.8977&lng=-77.0365&api_key={key}
Response:
{
"results": [{
"formatted_address": "1600 Pennsylvania Ave NW, Washington, DC 20500, USA",
"distance_meters": 5.2,
"components": {
"house_number": "1600",
"street": "Pennsylvania Avenue NW",
"city": "Washington",
"state": "DC",
"postal_code": "20500",
"country": "US"
}
}]
}GET /v1/validate?q=1600+Penn+Ave+Washington&country=US&api_key={key}
Response:
{
"valid": true,
"deliverable": true,
"corrected_address": "1600 Pennsylvania Avenue NW, Washington, DC 20500",
"confidence": 0.98,
"components": {
"house_number": "1600",
"street": "Pennsylvania Avenue NW",
"city": "Washington",
"state": "DC",
"postal_code": "20500"
}
}