Search

Returns a list of hotels matching a given keyword.

Changed on
get/reference-data/locations/hotel

Request

Query parameters

keywordstring required

Location query keyword

subTypestring[] required

Category of search - To enter several values, repeat the query parameter Use HOTEL_LEISURE to target aggregators or HOTEL_GDS to target directly the chains

countryCodestring

The country in which you search the subType. Country Code in ISO 3166-1 alpha-2 format

langstring

The language in which you want the results in following ISO 639-1.

If the language entered is not available then the results will be shown in the default language, English.

maxinteger

The number of results requested from 1 to 20

Response

Successful Search Operation

Example response

{
  "data": [
    {
      "id": 4630140,
      "name": "DE PARIS SAINT GEORGES EX KYRIAD PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "CTPARB08"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.88081,
        "longitude": 2.33541
      }
    },
    {
      "id": 4629897,
      "name": "DE PARIS OPERA EX DE PARIS MAUBEUGE",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "CTPARATH"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.87877,
        "longitude": 2.34593
      }
    },
    {
      "id": 4629762,
      "name": "LE PARISIS PARIS TOUR EIFFEL EX RAMADA",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "CTPARAPQ"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.8496,
        "longitude": 2.29553
      }
    },
    {
      "id": 4316057,
      "name": "COMFORT HOTEL PARIS LAFAYETTE PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "HVPARBHU"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.87646,
        "longitude": 2.34884
      }
    },
    {
      "id": 4629509,
      "name": "CAMPANILE PARIS 15 EX CAMPANILE PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "CTPARAIP"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.85,
        "longitude": 2.2884
      }
    },
    {
      "id": 4343671,
      "name": "THE ORIGINALS PARIS GARE DE L EST PARISI",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "TVPARAB7"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.8766,
        "longitude": 2.35422
      }
    },
    {
      "id": 4315654,
      "name": "CITADINES OPERA PARIS PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "HVPARAPG"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.87146,
        "longitude": 2.33834
      }
    },
    {
      "id": 4601316,
      "name": "THE ORIGINALS PARIS GARE DE L EST PARISI",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "SJPARALM"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.87661,
        "longitude": 2.35417
      }
    },
    {
      "id": 4905890,
      "name": "LE PARISIS PARIS TOUR EIFFEL",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "ADPAR093"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.84972,
        "longitude": 2.29565
      }
    },
    {
      "id": 4630373,
      "name": "HOTEL R DE PARIS EX DU CASINO PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "CTPARB6P"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.88004,
        "longitude": 2.32894
      }
    },
    {
      "id": 4930258,
      "name": "LE PARISIS PARIS TOUR EIFFEL",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 74,
      "type": "location",
      "hotelIds": [
        "XDPARAYA"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.84972,
        "longitude": 2.29565
      }
    },
    {
      "id": 4930306,
      "name": "THE ORIGINALS CITY HOTEL PARISIANA PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 72,
      "type": "location",
      "hotelIds": [
        "XDPARAZM"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.87663,
        "longitude": 2.35418
      }
    },
    {
      "id": 2330480,
      "name": "HOTEL PARADIS PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 71,
      "type": "location",
      "hotelIds": [
        "DGPARACN"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.8738,
        "longitude": 2.34993
      }
    },
    {
      "id": 4630331,
      "name": "MIDNIGHT HOTEL PARIS EX ARIS NORD",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 71,
      "type": "location",
      "hotelIds": [
        "CTPARB5J"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.8774,
        "longitude": 2.35609
      }
    },
    {
      "id": 4309354,
      "name": "HOTEL DE PARIS",
      "iataCode": "MOW",
      "subType": "HOTEL_LEISURE",
      "relevance": 70,
      "type": "location",
      "hotelIds": [
        "BKMOWB4L"
      ],
      "address": {
        "cityName": "THE HAGUE",
        "countryCode": "AU"
      },
      "geoCode": {
        "latitude": 55.76364,
        "longitude": 37.60079
      }
    },
    {
      "id": 4313435,
      "name": "PULLMAN PARIS TOUR EIFFEL HOTEL",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 70,
      "type": "location",
      "hotelIds": [
        "EYPARCQV"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.85598,
        "longitude": 2.29321
      }
    },
    {
      "id": 4313453,
      "name": "MERCURE PARIS CHAMPS ELYSEES",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 70,
      "type": "location",
      "hotelIds": [
        "EYPARCRN"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.86811,
        "longitude": 2.29095
      }
    },
    {
      "id": 4448070,
      "name": "THE WESTIN PARIS VENDOME",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 70,
      "type": "location",
      "hotelIds": [
        "ASPARADC"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.86561,
        "longitude": 2.32785
      }
    },
    {
      "id": 2356646,
      "name": "B B HOTEL PARIS PORTE DE LA VILLETTE",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 70,
      "type": "location",
      "hotelIds": [
        "GUPARBQV"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.901,
        "longitude": 2.387
      }
    },
    {
      "id": 4313461,
      "name": "TIVOLI HOTEL PARIS",
      "iataCode": "PAR",
      "subType": "HOTEL_LEISURE",
      "relevance": 70,
      "type": "location",
      "hotelIds": [
        "EYPARCRV"
      ],
      "address": {
        "cityName": "PARIS",
        "countryCode": "FR"
      },
      "geoCode": {
        "latitude": 48.87622,
        "longitude": 2.29592
      }
    }
  ]
}

Changes