ADDRESS AUTOCOMPLETE · TYPE-AHEAD API

Your customer types three letters. You get the whole address.

Address autocomplete for checkouts, signup forms and CRMs. Every suggestion comes back as clean, structured fields with point coordinates — so the address that lands in your database is already validated. Drop it into WordPress and WooCommerce with our plugin, or call the API directly.

Try it live API documentation

Try it live

Pick a country and start typing — this is the same /suggest call your checkout would make. United Kingdom addresses come from the official Royal Mail PAF, and you can search by postcode or by street. Japan starts with the 7-digit postal code, the way Japanese forms actually work.

Country State optional Address

🇯🇵 Japan starts with the postal code. In almost every Japanese checkout/web form, the customer types the 7-digit postal code first — the prefecture, city and town fill in automatically — and then enters only the banchi-gō (the house number). Don’t know the postcode? Start typing the neighbourhood in rōmaji (e.g. Ginza) or kanji (e.g. 銀座) and pick it from the list.

Selected address

— —

Acuris Geo · token-secured demo · 5 req/s · 200/session

Hold Ctrl + drag to tilt · see buildings in 3D

Included free with every suggestion

Autocomplete providers usually hand back a display string and charge you again to turn it into fields. Every suggestion we return is already broken into components, with coordinates attached:

Field	What it is
street, house_number, city, postcode, country	Structured components, ready to write straight into your form fields — no parsing the display string.
formatted_address	The address assembled in the correct order for that country, so a German address reads like a German address and a Japanese one like a Japanese one.
lat, lng	Point coordinates on the suggestion itself — you get the geocode as a side effect of the address capture, not as a second billed call.
hint	When the dropdown comes back empty, a short instruction telling the customer what to do next ("keep typing the street") instead of a dead box.

Because the suggestion is already structured and geocoded, the address you store is validated at the moment of capture — which is the cheapest possible place to catch a bad address.

One endpoint. JSON in, JSON out.

Send a GET to /suggest with what the customer has typed so far and the country. UK addresses are served from paf.acuris-geo.com, our dedicated Royal Mail PAF host; everything else from api.acuris-geo.com. Debounce on your side — around 200 ms per keystroke is what the demo above uses.

Request

# curl
curl 'https://api.acuris-geo.com/suggest?q=hammerstr+1+worms&country=deu&limit=5' \
  -H 'X-Acuris-Key: YOUR_KEY'

Response

{
  "suggestions": [
    {
      "street": "Hammerstr.",
      "house_number": "1",
      "city": "Worms",
      "postcode": "67549",
      "country": "deu",
      "lat": 49.63181,
      "lng": 8.35916,
      "formatted_address": "Hammerstr. 1\n67549 Worms\nGermany"
    }
  ]
}

The live demo above authenticates with a short-lived widget token rather than an API key, so the key never reaches the browser — the same pattern we recommend for your own front end. In production, call /suggest from your server, or mint a widget token per session.

No code? Install the WordPress plugin.

If your form already lives in WordPress, you don't need to write any JavaScript. Our plugin adds autocomplete to the fields you already have:

Integration	What it hooks
WooCommerce	Billing and shipping address fields at checkout — where a mistyped address costs you a failed delivery.
Gravity Forms	The address field, including its sub-fields.
Contact Form 7	Any address input in your form markup.
Elementor Forms	Address fields in Elementor's own form widget.
Anything else	Add `data-acuris-autocomplete="postcode"` to any input and it starts completing.

Paste your API key into the plugin settings, choose a default country, and it works. UK addresses are backed by the official Royal Mail PAF.

How autocomplete is billed — and why that matters

Address autocomplete is not billed like address validation, and the difference is worth understanding before you compare prices. The industry convention is free-find, billed-retrieve: searching as the customer types is free, and you are charged when a customer picks an address and you retrieve the full record. A customer who types twelve characters and selects once costs you one unit, not twelve.

Watch for two things when you compare providers:

What to check	Why
What counts as one billable unit	Some UK providers bill in Royal Mail "Transactions", where one query returning up to 100 records is a single unit. Per-address billing against the same data can work out very differently.
Whether coordinates cost extra	Ours are on the suggestion. Several providers treat the geocode as a separate, separately-billed product.
Whether structured fields cost extra	A display string you have to parse yourself is not the same product as clean components.

Full pricing, including the combined validation + geocoding allowances, is at acuris-geo.com/pricing.

Autocomplete is the front door. Validation is the rest of the house.

Autocomplete stops bad addresses being typed in the first place. For the addresses already sitting in your database — and for the ones that arrive through channels with no form at all — you want the validation side of the same API:

Product	Use it when
Address validation	You have an address already and need it verified, corrected and geocoded — one at a time or in bulk.
UK postcode lookup	You want every delivery point at a UK postcode, with UDPRN and UPRN.
Excel add-in	The list lives in a spreadsheet and nobody wants to write code.

Add autocomplete to your form today

Get an API key in under a minute — no credit card. Start with the WordPress plugin if your form is already there, or call /suggest directly.

Get a free API key Read the API docs