Hotel Airport Search

GET

Hotel Airport Search

A fast Hotel shopping API to see which hotels are available in a given area, on a given day and displays their lowest prices. With this API you can find out the price of the cheapest daily rate for all hotels near a given airport.

This API allows you to quickly see the locations of hotels near a given airport, and what prices in that area look like. Note that hotel images are not available to users outside of Amadeus, as we are not licensed to redistribute them. The API is based on our high-speed hotel pricing cache, which is also used to power the Amadeus Hotel Search Engine application. Results are returned very quickly, response times are generally under 2s. Our cache has great global coverage and is constantly refreshed with the latest prices.

Resource URL

https://api.sandbox.amadeus.com/v1.2 /hotels/search-airport

Query Parameters


Name Values Description
apikey
(required)

API Key provided for your account, to identify you for API access. Make sure to keep this API key secret.

location
(required)

IATA airport code for hotel availability is required requested.

check_in
(required)

Date on which the guest will begin their stay in the hotel. Past availability is not displayed, future availability becomes less useful from about 6 months from the current date.

check_out
(required)

Date on which the guest will end their stay in the hotel.

radius

Radius around the center to look for hotels in kilometers (km).

lang

The preferred language of the content related to each hotel. Content will be returned in this language if available.

currency

The preferred currency for the results

chain

Narrows the hotel search to a given hotel provider. The hotel chain is indicated by the first two characters of the property code.

max_rate

The maximum amount per night that any hotel in the shopping response should cost. This is calculated by dividing the total price of the stay for the given dates by the number of nights specified falling between the check_in and check_out dates.

number_of_results

The maximum number of hotels to return in the results set. Hotels are ordered by total price, so if more than the given maximum number of hotels are available, only the cheapest options are returned.

all_rooms

This option if enabled will return all hotel room rates, not just the lowest room rate. Note: This will have an impact on the response time due to the larger messages returned.

show_sold_out

This option if enabled will return hotel names and addresses even if rooms are sold out (closed properties)

amenity

Hotel amenities filter to search narrow down hotels with certain amenities. For example: amenity=POOL. (Note: multiple amenities can be used in searches: amenity=PARKING&amenity=RESTAURANT&amenity=PETS_ALLOWED).


Request Body

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Working...

 

Response format - Hotel Airport Search

The response is returned in JSON with the following elements:

Element Meaning Multiplicity
Root object
results The array of search result objects, sorted by price. The length of the array will correspond to the number_of_results parameter used in the input. 1..99
Result object
property_code The 8 character property code of this given hotel. The first 2 characters of this code are the chain code that can be specified in the input. The remaining elements are proprietary to each hotel chain. 1
property_name The name of this hotel. 1
location This hotel's approximate geolocation as a location object. 1
address This hotel's postal address as an address object. 0..1
total_price The lowest price of a stay, from the given check in date to the given check out date. 1
min_daily_rate The lowest price per day that the hotel offers between the given check-in and check-out dates. Extra taxes may apply to this rate. 1
contacts An array of contact objects to tell the user how to contact the hotel. Typically includes a phone and fax number. 0..n
amenities An array of amenity objects to the user what facilities this hotel might provide, such as a pool or parking. If this array is empty, it does not necessarily mean that there are no amenities available at this hotel, it could also mean that the hotel does not list their amenities in our search! 0..n
awards An array of hotel award objects to give the user an expectation of the service quality at this hotel. This can be used to indicate, for example, the star rating of a hotel. If this array is empty, it does not necessarily mean that the hotel has no awards, it could simply mean that they didn't tell us about them! 0..n
images A selection of image objects, showing pictures of the hotel building, the entrance or some rooms, to give an indication of what to expect at this hotel. Note that redistribution of images outside Amadeus products requires licensing from our image providers: Leonardo and Ice Portal. Thus image links are returned for whitelisted Amadeus users only. 0..n
Location object
latitude The north-south location of this hotel, in decimal degrees, between -90 and 90. 1
longitude The east-west location of this hotel, in decimal degrees, between -180 and 180. 1
Address object
line1 The first line of the hotel's address. Generally represents the hotel's basic street address. 1
city The town or city in which hotel is located. 1
region The state or region code in which the hotel is located. 0..1
postal_code The postal or zip code of this address. 0..1
country The ISO 3166-1 alpha-2 country code of this address. 0..1
Amenities object
amenity The amenity code 0..1
ota_code The Open Travel Alliance Hotel Amenities Code for this amenity. 0..1
description The decoded text description for this amenity code, where available. 0..1
Award object
provider The organization that issued the award. For example:. Local Star Rating, AAA. 0..1
rating The level of the award that was awarded on the provider's scale. For example: 4 or RECOMMENDED. 0..1
Image object
category The enumerated category of this image type. Common values include EXTERIOR, GUEST_ROOM, SUITE, LOBBY, RESTAURANT, LOUNGE, LOGO, MAP, MISC and UNKNOWN. 0..1
width The pixel width of the image at the provided URL. 0..1
height The pixel height of the image at the provided URL. 0..1
url The URL of the hotel image of this given category and size, for display. 0..1
Rooms object
booking_code The booking code identifies a product at the hotel. It can be used to book a room. 0..1
room_type_code A 3-letter code to identify a specific room type. The letters may be representative, for example A1Q: A=Superior, 1=1 bed, Q=Queen size. 1
rate_plan_code A 3 letter code to designate different rates base on traveler type. 1
Total amount object
amount Total amount for the stay period. For example: $194.99. 1
currency Currency code of the total amount. For example: "USD". 1
rates object An array of room rate objects including start_date, end_date, currency_code and price for the given stay period. If room rates are different during the stay period, multiple rate objects are displayed with various rates corresponding to their dates. 1..n
descriptions An array of description objects describing room and rate types features. 0..n
 

Example - Hotel Airport Search

Here's a search example. Just copy the following URLs in your browser. Don't forget to adjust the check-in and check-out dates as necessary, and use your own API key.

Simple airport search

Find all hotels within 2 km of Boston airport with restaurants and parking amenities:

Request

https://api.sandbox.amadeus.com/v1.2/hotels/search-airport?apikey=YOUR_API_KEY_HERE&location=BOS&check_in=2016-03-14&check_out=2016-03-16&amenity=RESTAURANT&amenity=PARKING&number_of_results=2

Response

				{
  "results" : [ {
    "property_code" : "WYBOSCHH",
    "property_name" : "Wyndham Boston Chelsea",
    "location" : {
      "latitude" : 42.39795,
      "longitude" : -71.03977
    },
    "address" : {
      "line1" : "201 Everett Avenue",
      "city" : "Chelsea",
      "region" : "MA",
      "postal_code" : "02150-1816",
      "country" : "US"
    },
    "total_price" : {
      "amount" : "287.30",
      "currency" : "USD"
    },
    "min_daily_rate" : {
      "amount" : "71.82",
      "currency" : "USD"
    },
    "contacts" : [ {
      "type" : "PHONE",
      "detail" : "1-617-8842900"
    }, {
      "type" : "FAX",
      "detail" : "1-617-8847888"
    } ],
    "amenities" : [ {
      "amenity" : "ICE_MACHINE",
      "ota_code" : 52,
      "description" : "Ice machine"
    }, {
      "amenity" : "RESTAURANT",
      "ota_code" : 76,
      "description" : "Restaurant"
    }, {
      "amenity" : "BABY_SITTING",
      "ota_code" : 8,
      "description" : "Baby sitting"
    }, {
      "amenity" : "BEAUTY_SALON",
      "ota_code" : 107,
      "description" : "Beauty shop/salon"
    }, {
      "amenity" : "ELEVATORS",
      "ota_code" : 33,
      "description" : "Elevators"
    }, {
      "amenity" : "INTERNET_PUBLIC_AREAS",
      "ota_code" : 178,
      "description" : "Internet access in public areas"
    }, {
      "amenity" : "JACUZZI",
      "ota_code" : 55,
      "description" : "Jacuzzi"
    }, {
      "amenity" : "LAUNDRY_SERVICE",
      "ota_code" : 58,
      "description" : "Laundry/Valet service"
    }, {
      "amenity" : "PARKING",
      "ota_code" : 68,
      "description" : "Parking"
    }, {
      "amenity" : "LOUNGE_BARS",
      "ota_code" : 165,
      "description" : "Lounges/bars"
    }, {
      "amenity" : "POOL",
      "ota_code" : 71,
      "description" : "Pool"
    }, {
      "amenity" : "OUTDOOR_POOL",
      "ota_code" : 66,
      "description" : "Outdoor pool"
    } ],
    "awards" : [ {
      "provider" : "Local Star Rating",
      "rating" : "3"
    }, {
      "provider" : "AAA",
      "rating" : "3"
    } ],
    "images" : [ {
      "category" : "MAIN_IMAGE",
      "width" : 70,
      "height" : 70,
      "url" : "http://multimediarepository.amadeus.com/cmr/retrieve/hotel/5811669CC5364943965EC9FB3D56642C/A"
    }, {
      "category" : "MAIN_IMAGE",
      "width" : 480,
      "height" : 260,
      "url" : "http://multimediarepository.amadeus.com/cmr/retrieve/hotel/5811669CC5364943965EC9FB3D56642C/J"
    } ],
    "rooms" : [ {
      "booking_code" : "N2DA01",
      "room_type_code" : "N2D",
      "rate_plan_code" : "A01",
      "total_amount" : {
        "amount" : "287.30",
        "currency" : "USD"
      },
      "rates" : [ {
        "start_date" : "2016-03-14",
        "end_date" : "2016-03-16",
        "currency_code" : "USD",
        "price" : 143.65
      } ],
      "descriptions" : [ "PAY NOW GET 200 BONUS POINTS", "2 DOUBLE BED ROOM, WIFI, 32 INCH FLAT SCREEN", "TV." ],
      "room_type_info" : {
        "room_type" : "Non-smoking",
        "bed_type" : "Double",
        "number_of_beds" : "2"
      },
      "rate_type_code" : "A01"
    } ],
    "_links" : {
      "more_rooms_at_this_hotel" : {
        "href" : "http://api.sandbox.amadeus.com/v1.2/hotels/WYBOSCHH?apikey=zO8hvuhC5ejQBwJgMcGzS19fGpExrRuQ&check_in=2016-03-14&check_out=2016-03-16"
      }
    }
  }, {
    "property_code" : "HYBOSHHS",
    "property_name" : "Hyatt Regency Boston Harbor",
    "location" : {
      "latitude" : 42.35914,
      "longitude" : -71.02742
    },
    "address" : {
      "line1" : "101 Harborside Dr",
      "city" : "Boston",
      "region" : "MA",
      "postal_code" : "02128",
      "country" : "US"
    },
    "total_price" : {
      "amount" : "297.44",
      "currency" : "USD"
    },
    "min_daily_rate" : {
      "amount" : "139.92",
      "currency" : "USD"
    },
    "contacts" : [ {
      "type" : "PHONE",
      "detail" : "1-617-568-1234"
    }, {
      "type" : "FAX",
      "detail" : "1-617-567-8856"
    } ],
    "amenities" : [ {
      "amenity" : "COFFEE_SHOP",
      "ota_code" : 20,
      "description" : "Coffee shop"
    }, {
      "amenity" : "RESTAURANT",
      "ota_code" : 76,
      "description" : "Restaurant"
    }, {
      "amenity" : "ACCESSIBLE_FACILITIES",
      "ota_code" : 47,
      "description" : "Accessible facilities"
    }, {
      "amenity" : "BABY_SITTING",
      "ota_code" : 8,
      "description" : "Baby sitting"
    }, {
      "amenity" : "CAR_RENTAL",
      "ota_code" : 15,
      "description" : "Car rental desk"
    }, {
      "amenity" : "CHILDREN_WELCOME",
      "ota_code" : 218,
      "description" : "Children welcome"
    }, {
      "amenity" : "ELEVATORS",
      "ota_code" : 33,
      "description" : "Elevators"
    }, {
      "amenity" : "CURRENCY_EXCHANGE",
      "ota_code" : 26,
      "description" : "Currency exchange"
    }, {
      "amenity" : "GIFT_SHOP",
      "ota_code" : 45,
      "description" : "Gift/News stand"
    }, {
      "amenity" : "FREE_HIGH_SPEED_INTERNET",
      "ota_code" : 222,
      "description" : "Free high speed internet connection"
    }, {
      "amenity" : "INTERNET_PUBLIC_AREAS",
      "ota_code" : 178,
      "description" : "Internet access in public areas"
    }, {
      "amenity" : "PARKING",
      "ota_code" : 68,
      "description" : "Parking"
    }, {
      "amenity" : "PETS_ALLOWED",
      "ota_code" : 224,
      "description" : "Pets allowed"
    }, {
      "amenity" : "VALET_PARKING",
      "ota_code" : 97,
      "description" : "Valet parking "
    }, {
      "amenity" : "LOUNGE_BARS",
      "ota_code" : 165,
      "description" : "Lounges/bars"
    }, {
      "amenity" : "LOUNGE_BARS",
      "ota_code" : 165,
      "description" : "Lounges/bars"
    }, {
      "amenity" : "ROOM_SERVICE",
      "ota_code" : 77,
      "description" : "Room service"
    }, {
      "amenity" : "SAFE_DEPOSIT_BOX",
      "ota_code" : 78,
      "description" : "Safe deposit box"
    }, {
      "amenity" : "BALLROOM",
      "ota_code" : 191,
      "description" : "Ballroom"
    } ],
    "awards" : [ ],
    "images" : [ {
      "category" : "MAIN_IMAGE",
      "width" : 70,
      "height" : 70,
      "url" : "http://multimediarepository.amadeus.com/cmr/retrieve/hotel/AE3C4B469985434AB8E48B23FD4A50CD/A"
    }, {
      "category" : "MAIN_IMAGE",
      "width" : 320,
      "height" : 480,
      "url" : "http://multimediarepository.amadeus.com/cmr/retrieve/hotel/AE3C4B469985434AB8E48B23FD4A50CD/J"
    } ],
    "rooms" : [ {
      "booking_code" : "KNGADPR",
      "room_type_code" : "A1K",
      "rate_plan_code" : "***",
      "total_amount" : {
        "amount" : "297.44",
        "currency" : "USD"
      },
      "rates" : [ {
        "start_date" : "2016-03-14",
        "end_date" : "2016-03-15",
        "currency_code" : "USD",
        "price" : 139.92
      }, {
        "start_date" : "2016-03-15",
        "end_date" : "2016-03-16",
        "currency_code" : "USD",
        "price" : 157.52
      } ],
      "descriptions" : [ "ADV PURCHASE* AVIATION KING", "1 KING BED: COFFEE MAKER:DATAPORT:" ],
      "room_type_info" : {
        "room_type" : "Room with bath - Superior",
        "bed_type" : "King",
        "number_of_beds" : "1"
      },
      "rate_type_code" : "***"
    } ],
    "_links" : {
      "more_rooms_at_this_hotel" : {
        "href" : "http://api.sandbox.amadeus.com/v1.2/hotels/HYBOSHHS?apikey=zO8hvuhC5ejQBwJgMcGzS19fGpExrRuQ&check_in=2016-03-14&check_out=2016-03-16"
      }
    }
  } ]
}
			

Error Example

A request with a check-in date after the check-out date.

http://api.sandbox.amadeus.com/v1.2/hotels/search-airport?location=BWI&radius=50&check_in=2015-07-28&check_out=2015-07-02&chain=RT¤cy=EUR&number_of_results=50&apikey=<your API key>

Response

{
  "status" : 400,
  "message" : "2015-07-28/2015-07-02 is not a valid check_in/check_out. Expected the check-in date to be before the check-out date"
}

 

OTA Hotel Amenity Code Table

This is the OTA Hotel Amenity Code Table used to supply amenity information. The 2014A code table is used by the API. To stay up to date, sign up to receive the official code table from the Open Travel Alliance.