Loading
CTRL+K
Loading
Our reverse geocoding API takes a latitude and longitude pair and returns the nearest matching address with a complete breakdown of every administrative level: street, neighbourhood, postcode, city, county, state with its ISO 3166-2 code, and country. When the coordinates fall on or near a known place, the response also includes a poi array with the name, category, and type of that point of interest. A single full_address field delivers everything as a readable string, and a bounding_box covers the spatial extent of the matched feature.
It accepts WGS84 coordinates directly from GPS receivers and mobile sensors with no conversion required and supports multi-language output via the Accept-Language header. Commonly used in ride sharing apps, asset tracking, delivery platforms, photo tagging, location context features, and any application that captures a location pin and needs to show it as a readable address.
Submit a lat and lon and receive the nearest matching street address as a structured JSON object, including a single-line full_address field ready for display or storage.
When coordinates resolve to a known amenity, building, or landmark, the poi array returns its name, category, and type alongside the standard address fields.
The response includes individual fields for street, neighbourhood, postcode, city, county, state, and country. Use the fields you need or rely on full_address for a pre-formatted single line.
The state_code field returns a standardized subdivision identifier such as US-TX or US-NY, making it straightforward to normalize location data across global datasets.
Pass an Accept-Language header to receive address data in a preferred language. Defaults to English when the requested language is unavailable for a given location.
Accepts coordinates in the WGS84 decimal degree format produced by GPS receivers, mobile devices, and most mapping platforms. No coordinate transformation needed before making the request.
Each response includes a bounding_box with the spatial extent of the matched feature expressed as [lat_min, lat_max, lon_min, lon_max] in WGS84 decimal degrees.
$ pip install requests
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| lat | Yes | Float | — | Latitude of the location. Valid range: -90 to 90. |
| lon | Yes | Float | — | Longitude of the location. Valid range: -180 to 180. |
| Header | Required | Type | Default | Description |
|---|---|---|---|---|
| Accept-Language | No | String | en | Language preference for results. Single code or comma-separated list. Falls back to English if needed. |
Returns a single JSON object for the nearest address match to the submitted coordinates. For an interactive view of the full response, see the Reverse Geocoding API Test Page Click here.
| HTTP Status | Reasons |
|---|---|
| 400 | (1) Please provide valid parameters.
(2) Latitude must be between -90 and 90.
(3) Longitude must be between -180 and 180.
(4) Please provide a valid latitude value.
(5) Please provide a valid longitude value. |
| 404 | No results found for the given query. |
| 500 | Internal Server Error Occurred. |
Submit a coordinate pair to retrieve the nearest matching address. The response returns one result.
# Response { "lat": 40.7489669, "lon": -73.985399, "name": "LensCrafters", "category": "shop", "type": "optician", "poi": [ { "name": "LensCrafters", "category": "shop", "type": "optician" }, { "name": "7", "category": "place", "type": "house_number" } ], "street": "West 34th Street", "area": "Manhattan, New York County", "postcode": "10001", "city": "New York", "state_code": "US-NY", "state": "New York", "country_code": "US", "country": "United States", "full_address": "LensCrafters, 7, West 34th Street, Midtown South, Manhattan Community Board 5, Manhattan, New York County, New York, 10001, United States", "bounding_box": [ "40.7489169", "40.7490169", "-73.9854490", "-73.9853490" ] }curl "https://api.apifreaks.com/v1.0/geocoder/reverse?apiKey=YOUR_API_KEY&lat=40.748817&lon=-73.985428"
Add the Accept-Language header to receive place names and address components in a preferred language.
# Response { "lat": 48.8582599, "lon": 2.2945006358633115, "name": "Tour Eiffel", "category": "tourism", "type": "attraction", "poi": [ { "name": "Tour Eiffel", "category": "historic", "type": "monument" }, { "name": "5", "category": "place", "type": "house_number" } ], "street": "Avenue Anatole France", "area": "Paris, Paris", "postcode": "75007", "city": "Paris", "state_code": "FR-IDF", "state": "Île-de-France, France métropolitaine", "country_code": "FR", "country": "France", "full_address": "Tour Eiffel, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, Île-de-France, France métropolitaine, 75007, France", "bounding_box": [ "48.8574753", "48.8590453", "2.2933119", "2.2956897" ] }curl "https://api.apifreaks.com/v1.0/geocoder/reverse?apiKey=YOUR_API_KEY&lat=48.8584&lon=2.2945" -H "Accept-Language: fr"
lat and lon are required. Missing either returns a 400 error.The API always returns one result: the nearest address to the coordinates submitted.The poi array only appears when the coordinates resolve to a known point of interest.Coordinates outside valid WGS84 ranges return a 400 error.If no address match exists for the coordinates, the API returns a 404.To use the Reverse Geocoding API, you will need API credits. We only charge for successful queries, defined by a 2xx status code. If your request results in a 4xx or 5xx status code, no credits will be charged, and any deducted credits will be returned.
For Each Successful request 5 credits will be charged.
Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.