Skip to content
POST AI agent ready /v1/address/autocomplete

Address Autocomplete API - Free Address Suggestions

Send a partial address query and get back up to 10 structured address suggestions with street, city, state, country, and GPS coordinates. Designed for search-as-you-type address fields. Supports language preference for localized results.

Parameters

stringrequired

Partial address to autocomplete.

number

Max suggestions to return (1-10).

string

ISO 639-1 language code for results.

Code examples

curl -X POST https://api.botoi.com/v1/address/autocomplete \
  -H "Content-Type: application/json" \
  -d '{"query":"1600 Amphithea","limit":3,"lang":"en"}'

When to use this API

Build search-as-you-type address fields

Wire this endpoint to an input field with debounced requests. Show a dropdown of matching addresses as the user types. When they select one, populate street, city, state, and zip fields automatically.

Reduce form errors on mobile checkout

Mobile users make more typos than desktop users. Autocomplete suggestions let them tap the correct address instead of typing it fully, cutting form completion time and error rates.

Power location search in mapping applications

Use autocomplete to let users search for places by name or address. Each suggestion includes coordinates, so you can center the map on the selected result without a separate geocoding call.

Frequently asked questions

How many suggestions can I request?
Set the limit parameter between 1 and 10. The default is 5. The API returns at most the number of matching results found, which may be fewer than the limit.
What languages are supported?
Pass any ISO 639-1 language code (e.g., "de" for German, "ja" for Japanese). Results are returned in the requested language when translations are available. Falls back to the local language otherwise.
Is there a minimum query length?
The query must be at least one non-whitespace character. Shorter queries return broader results. For best suggestions, send at least 3-4 characters.
Does this work for business names or street addresses?
It works for both. The geocoder matches street addresses, neighborhoods, cities, and named places. Business names may or may not match depending on mapping database coverage.
What is the response time?
Typical response times are 100-300ms depending on the geocoding service load. For a smooth typeahead experience, debounce requests to fire 150-200ms after the user stops typing.

Get your API key

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

Sign up free View full docs