Location autocomplete API

Location autocomplete API for apps and forms

PlaceField returns structured city, region, and country suggestions for backend services, apps, and production forms. Use it when your application needs clean place lookup or place-level geocoding, not address autocomplete, POI search, routing, or map UI.

Structured response

Store stable IDs, place type, display label, hierarchy, country, and coordinates without parsing a broad maps result.

Production controls

Use server keys for backend calls or public browser keys with exact allowed origins for frontend integrations.

Designed for city, region, and country search

General place search APIs are built for many jobs at once. PlaceField is deliberately narrower, so application records and form results stay relevant and easier to store.

Good fits include backend normalization, signup forms, profile location fields, marketplace listings, directories, communities, CRMs, and privacy-friendly city-level workflows. If you are still choosing what kind of field to collect, start with the location autocomplete decision guide. Browse runnable API and widget samples in the PlaceField examples repo.

Example request

GET https://api.placefield.dev/v1/locations/autocomplete?q=paris&geoBias=none
Authorization: Bearer pf_live_xxx

What the API returns

Autocomplete results include fields your application can keep: stable location IDs, type, name, label, country, parent hierarchy, and coordinates where available.

Stable location IDs

Keep a PlaceField ID instead of storing only free text from an autocomplete input.

Country and geographic ranking

Bias ranking by explicit country, restrict results with country allowlists, or prefer requester-country and nearby results when no country is supplied.

No POI noise

Keep businesses, venues, street names, and address fragments out of city and country fields.

Widget optional

Call the API directly or choose Basic JS and Full Widget integrations when you want browser UI.

Need city-specific autocomplete?

If your workflow only needs a city-level location, PlaceField can keep the result focused while still returning country, hierarchy, and coordinates.

View city-level forms

Looking for city geocoding?

PlaceField covers the narrow geocoding-style case where a product needs a city, region, country, stable ID, and coordinates from a place search. It is not a full address or reverse geocoding API.

View city geocoding use case

Choosing between city and address autocomplete?

Use the guide to decide whether your workflow needs a broad city, region, and country field or a complete street address.

Read the guide

Tell us about your API integration

Share the application workflow you are building and whether the API will run from your backend, browser, or both.