POST AI agent ready /v1/geo/geocode

Geocoding API - Free Address to Coordinates

Send an address string (street address, city name, landmark, or postal code) and receive the corresponding latitude, longitude, display name, and location type. Powered by the OpenStreetMap Nominatim service. Supports worldwide addresses in any language.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/geocode \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Convert user-entered addresses to map pins in your app

When a user types an address in a form, geocode it and place a marker on the map. This replaces the need for a paid Google Maps Geocoding API in many use cases.

Enrich your CRM or database records with coordinates

Batch-geocode customer addresses to add lat/lng fields. Use the coordinates for proximity searches, delivery zone calculations, or geographic reporting.

Frequently asked questions

What geocoding provider powers this endpoint?

OpenStreetMap Nominatim. Results reflect OpenStreetMap data quality, which is strong in most countries but may be less detailed in rural or developing areas.

Does this endpoint support non-English addresses?

Yes. Nominatim supports addresses in most languages and scripts. You can send addresses in Japanese, Arabic, Cyrillic, or any language supported by OpenStreetMap.

What happens if the address is ambiguous or not found?

If no results match, the API returns a 404 NOT_FOUND error. For ambiguous addresses, the API returns the top match. Be as specific as possible (include city, state, country) for better accuracy.

Is there a rate limit on geocoding requests?

Anonymous access allows 5 requests per minute. With an API key, the rate limit is determined by your plan. Nominatim itself has a 1 request/second policy, which this endpoint respects.

Can I geocode IP addresses with this endpoint?

No. This endpoint converts street addresses to coordinates. For IP geolocation, use the /v1/ip/lookup endpoint.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.