Get started

Geocoding for your application

Geocode addresses, reverse geocode locations, and add address autocomplete.

Affordable Geo APIs gives you address geocoding, free-text search, reverse geocoding, and autocomplete through one simple GET API that returns GeoJSON. Use a server SDK to add Google or HERE as a backup provider, or the browser client for autocomplete with a public token.

QuickstartMake your first authenticated geocoding request.API referenceExplore endpoints, request fields, and responses.SDK librariesBuild with Node.js, Python, or PHP.Provider fallbacksChoose when to call Google or HERE.

Your first request

Send a street address and at least one location field. Set the URL and API key for your deployment:

Terminal

curl --get "$GEOCODING_BASE_URL/v1/geocode" \
  --header "apikey: $GEOCODING_API_KEY" \
  --data-urlencode "street=11 Wall Street" \
  --data-urlencode "city=New York" \
  --data-urlencode "state=NY"

The response lists matching addresses with coordinates, a confidence score, and a data source. A valid request with no matches returns an empty features array.

Choose your integration

Library	Runtime	Start here
Node.js	Node.js 22+ · TypeScript or JavaScript	Node.js SDK
Browser JavaScript	Fetch and ES modules · any frontend framework	Browser autocomplete
Python	Python 3.11+ · blocking or asyncio	Python SDK
PHP	PHP 8.2+ · cURL	PHP SDK
C# / .NET	.NET 8+ · async	.NET SDK
HTTP	Any backend with an HTTP client	API reference

The SDKs currently install from repository source or a local package. Each library page includes installation steps.

Understand a match

The SDK's primary route covers Canada, the United States, and Mexico. Configure a backup for other country hints. Actual API coverage depends on the deployment's dataset.

Review confidence scores when choosing a candidate. Scores are provider-specific. See country routing for international requests.