Places API

Address Autocomplete API

Find addresses, streets, postcodes & places

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

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 Coordinate

Prioritises results near a lat,lon coordinate.

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


Float

Only search within this distance in metres from a biasTowards coordinate.


Enum

Units to display any distances in, such as how far a result is from a biasTowards coordinate. Options are:

IMPERIALDefault

Distance under 0.1 miles displayed in feet, anything above in miles

METRIC

Distance under 1 kilometre displayed in metres, anything above in kilometres

MI

Distance displayed in miles

FT

Distance displayed in feet

KM

Distance displayed in kilometres

M

Distance displayed in metres


Integer

Maximum number of results to return, up to 5.


String

Type of result to return. Options are:

Address

Street

Locality

Postcode

Response