Search
Returns a list of hotels matching a given keyword.
Changed onget/reference-data/locations/hotel
Request
- Base URLhttps://test.api.amadeus.com/v1
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
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
- info
api operation id
gethotelswas added
- info