Skip to content
All endpoints

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

  • querystringrequired

    Destination 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"

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.

FieldTypeSample / Notes
codeintegerExample: 0
providerstring
statusstringExample: ok
dataobject
querystring
countinteger
destinationsarray of object
destination_idstring
location_namestring
display_namestring
country_codestringnull
termsarray of string
metaResponseMeta
request_idstring
endpointstring
credits_chargedinteger
cachedboolean
took_msinteger

Status Codes

200
Normalized travel destination predictions.
401