Autocomplete travel destinations, cities & neighborhoods
GET/v1/stays/destinations· Updated 2026-11-15
Resolves partial city, island, or neighborhood strings into structured destination place IDs, display labels, and ISO country codes. Cost: 2 Credits / request.
Parameters
querystringrequiredDestination prefix or city name (also accepts
q).
Example Request (cURL / Python / JavaScript)
curl "https://api.pindataapi.com/v1/stays/destinations?query=" \
-H "x-api-key: pn_live_your_api_key"import requests
res = requests.get(
"https://api.pindataapi.com/v1/stays/destinations?query=",
headers={"x-api-key": "pn_live_your_api_key"},
timeout=30,
)
print(res.json())const res = await fetch("https://api.pindataapi.com/v1/stays/destinations?query=", {
headers: { "x-api-key": "pn_live_your_api_key" },
});
const data = await res.json();
console.log(data);Live Response Preview
{
"code": 0,
"provider": "https://pindataapi.com",
"status": "ok",
"msg": "success",
"data": {
"query": "Paris",
"count": 3,
"destinations": [
{
"destination_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
"query_key": "paris",
"location_name": "Paris, France",
"display_name": "Paris, France",
"country_code": "FR",
"terms": [
"[object Object]",
"[object Object]"
]
},
{
"destination_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
"query_key": "paris",
"location_name": "Paris, France",
"display_name": "Paris, France stays",
"country_code": "FR",
"terms": [
"[object Object]",
"[object Object]"
]
},
{
"destination_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
"query_key": "paris",
"location_name": "Paris, France",
"display_name": "Paris, France experiences",
"country_code": "FR",
"terms": [
"[object Object]",
"[object Object]"
]
}
]
},
"meta": {
"request_id": "8b557174-ff35-4ded-9ede-3e24ef579140",
"endpoint": "/v1/stays/destinations",
"credits_charged": 2,
"cached": true,
"took_ms": 0
}
}Response Fields
Normalized travel destination predictions.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | |
status | string | Example: ok |
data | object | |
query | string | |
count | integer | |
destinations | array of object | |
destination_id | string | |
location_name | string | |
display_name | string | |
country_code | stringnull | |
terms | array of string | |
meta | ResponseMeta | |
request_id | string | |
endpoint | string | |
credits_charged | integer | |
cached | boolean | |
took_ms | integer |
Status Codes
- 200
- Normalized travel destination predictions.
- 401