Places API

Address Autocomplete API

Find addresses, streets, postcodes & places

GEThttps://api.swiftcomplete.com/v1/places/?key=&text=&biasTowards=&maxResults=&searchFor=&distanceUnits=

Returns a list of addresses, sorted alphabetically or by distance from a coordinate.

Addresses are matched against our reference datasets, and additionally using Artificial Intelligence to extract and format as much of the address as possible. For example, where we only hold street level data for a country, we use AI to detect, format and return building information to improve coverage.

The API doesn't guarantee that an address exists, but is designed to match and format as much information about an address as possible.

Check our current data coverage here.

Parameters

API Key

Authenticate every request with your API key in the URL, or as a header.

Use SANDBOX_DEMO_KEY to test the API for free with preset locations, or sign up and create a free API key to try any location of your choice.


String

Search term containing part of an address, street, place or postcode.

If not provided, results are returned near biasTowards.


WGS84 Coordinates

Bias results towards up to 2 pairs of lat,lon coordinates.

If not provided, results are biased towards your approximate location determined by your IP address.


Integer

Maximum number of results to return, up to 5.


String

Type of result to return. Options are:

Address

Street

Locality

Postcode


String

Units to display any distances in. Options are:

Imperial

Metric

If not provided, units default to imperial.

Response