Skip to main content

Quick start guide

Introduction​

The Autosuggest API returns a list of places that match a specified searchTerm.

Sample requests​

/flights​

curl --request POST 'https://partners.api.skyscanner.net/apiservices/v3/autosuggest/flights' \
--header 'x-api-key: your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
  "query":{
    "market": "UK",
    "locale": "en-GB",
    "searchTerm": "London",
     "includedEntityTypes": [ "PLACE_TYPE_CITY", "PLACE_TYPE_COUNTRY", "PLACE_TYPE_AIRPORT"]
  },
  "limit": 20,
  "isDestination": true
}'

/hotels​

curl --request POST 'https://partners.api.skyscanner.net/apiservices/v3/autosuggest/hotels' \
--header 'x-api-key: your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": {
        "market": "UK",
        "locale": "en-GB",
        "searchTerm": "madri",
        "includedEntityTypes": [
            "PLACE_TYPE_COUNTRY", "PLACE_TYPE_CITY", "PLACE_TYPE_HOTEL", "PLACE_TYPE_DISTRICT", "PLACE_TYPE_ISLAND", "PLACE_TYPE_FIRST_LEVEL_NATION_ADMINISTRATIVE_DIVISION", "PLACE_TYPE_SECOND_LEVEL_NATION_ADMINISTRATIVE_DIVISION", "PLACE_TYPE_SEA_COAST", "PLACE_TYPE_MOUNTAIN_RANGE", "PLACE_TYPE_SEA"
        ]
    }
}'

/carhire​

curl --request POST 'https://partners.api.skyscanner.net/apiservices/v3/autosuggest/carhire' \
--header 'x-api-key: your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": {
        "market": "UK",
        "locale": "en-GB",
        "searchTerm": "edi"
    }
}'

API documentation​

For more information please refer to the Autosuggest API documentation