Private Beta—Found a bug or have feedback? Share it →

Geocoding

Convert city names, addresses, and place names to coordinates and vice versa. Powered by OpenStreetMap Nominatim. Free, no key required.

Healthy

LocationNo upstream key required

Base URL

https://api.apiclearinghouse.com/v1/call/geocoding

Authenticate with X-Api-Key: chk_live_... header.

GET/search

Parameters

Name	Type	Required	Description
q	string	required	Location search query
limit	number	optional	Max results (1-10)(default: 5)

Example Request

curl -s "https://api.apiclearinghouse.com/v1/call/geocoding/search?q={q}&limit=5" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response

{
  "status": "success",
  "data": {
    "results": "example"
  }
}

GET/reverse

Parameters

Name	Type	Required	Description
lat	number	required	Latitude
lon	number	required	Longitude

Example Request

curl -s "https://api.apiclearinghouse.com/v1/call/geocoding/reverse?lat={lat}&lon={lon}" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response

{
  "status": "success",
  "data": {
    "city": "example",
    "country": "example",
    "postcode": "example",
    "country_code": "example",
    "display_name": "example"
  }
}

Try it live

No setup required. Sign in and run Geocoding directly from your browser.

Open in Explorer →

Rate Limits

Free10/min

Pro100/min

Elite500/min

Monthly limits also apply per plan.

Authentication

Pass your API key in the request header:

X-Api-Key: chk_live_...

Join the beta

← Back to catalog