Skip to main content

​
Method

GET /v1/places/autocomplete

​
Query Parameters

​
q
string
required
Search input (minimum 3 characters). Alias: input.
​
kind
string
Limit results to city or airport.

​
Headers

​
Authorization
string
Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

​
Request Example

curl "https://api.voyantcloud.com/v1/places/autocomplete?q=Paris&kind=city" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

​
Response

{
  "predictions": [
    {
      "place_id": "ChIJdUyx15EuEmsR3E0i9zlBzJ0",
      "description": "Paris, France",
      "structured_formatting": {
        "main_text": "Paris",
        "secondary_text": "France"
      }
    },
    {
      "place_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
      "description": "Paris, Île-de-France, France",
      "structured_formatting": {
        "main_text": "Paris",
        "secondary_text": "Île-de-France, France"
      }
    }
  ]
}
Send at least three characters. Shorter queries return an empty array without calling Google Places.