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.
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.
Search term containing part of an address, street, place or postcode.
If not provided, results are returned near biasTowards.
Prioritises results near a lat,lon coordinate.
If not provided, results are biased towards your approximate location determined by your IP address.
Only search within this distance in metres from a biasTowards coordinate.
Units to display any distances in, such as how far a result is from a biasTowards coordinate. Options are:
Distance under 0.1 miles displayed in feet, anything above in miles
Distance under 1 kilometre displayed in metres, anything above in kilometres
Distance displayed in miles
Distance displayed in feet
Distance displayed in kilometres
Distance displayed in metres
Maximum number of results to return, up to 5.
Type of result to return. Options are: