GET places

ideal-postcodes.co.uk

Summary: Find Place
Operation ID: FindPlace
Auth: unknown
Description

Query for geographical places across countries. Each query will return a list of place suggestions, which consists of a place name, descriptive name and id. This API returns geographical information such as countries, capitals, administrative areas and more. It is ideal for correctly identifying a place along with any other details like geolocation. ## Implementing Place Autocomplete Extracting the full information of a place is a 2 step process: 1. Retrieve place suggestions via /places 2. Retrieve the entire place with the ID provided in the suggestion ## Suggestion Format Each place suggestion contains a descriptive name which you can provide to users to uniquely idenfity a place. ## Rate Limiting You can make up to 3000 requests to the autocomplete API within a 5 minute span. The HTTP Header contains information on your current rate limit. | Header | Description | | ----------------------- | -------------------------------------------------------------------------------------- | | `X-RateLimit-Limit` | The maximum number of requests that can be made in 5 minutes | | `X-RateLimit-Remaining` | The remaining requests within the current rate limit window | | `X-RateLimit-Reset` | The time when the rate limit window resets in Unix Time (seconds) or UTC Epoch seconds | ## Pricing This API currently does not affect your balance. However, resolving a suggestion into a full place requires a paid request. Please note, this API is not intended as a standalone free resource. Integrations that consistently make autocomplete requests without a paid request to resolve an place may be disrupted via tightened rate limits.

Parameters (6)

api_key (?, query, required)
bias_country_iso (?, query, optional)
bias_ip (?, query, optional)
bias_lonlat (?, query, optional)
country_iso (?, query, optional)
query (string, query, optional)

Specifies the place you wish to query. Query can be shortened to `q=`

No probe data for this endpoint yet.