/hotel_inventory

Inventory requests are sent by appending /hotel_inventory to your endpoint and sending the parameters described below in a GET request.

 

Important: You must provide your full inventory (full list of hotels) and remove all test properties for us to consider your implementation complete.

Tripadvisor expects you to continue to provide your entire inventory and return availability for all your properties.

Once a day Tripadvisor imports your list of hotels from your hotel_inventory response. We then match these to Tripadvisor listings. The import could fail if you response does not conform to the below specification, it could also fail is you omit the url or have listings with duplicate URLs.

Request

http://www.partner-site.com/api_implementation/hotel_inventory?lang=en&api_version=8&inventory_type=tripconnect

Query Parameters

Name Type Description
api_version number
The version of the API that this request is using.
lang string
Language code (see Supported Languages). The language that Tripadvisor would prefer that the partner return content in. If the partner does not have the language of the request, they can return a less specific language. e.g. If the request is asking for de_AT, then the response can be de. If the partner does not have the language, they may return a response with any language.
inventory_type string
The type of inventory that is being requested.

Response

ContentType: application/json

{
    "api_version" : 8,
    "lang" : "en_US",
    "hotels" :
        [
            {
                "ta_id" : 258705 ,
                "partner_id" : "hc",
                "name" : "Hotel Commonwealth",
                "street" : "500 Commonwealth Avenue",
                "city" : "Boston",
                "postal_code" : "02215",
                "state" : "Massachusetts",
                "country" : "USA",
                "latitude" : 42.348808,
                "longitude" : -71.094971,
                "desc" : "The Hotel Commonwealth stands above the Kenmore Square \"T\" subway station in Boston, Mass. Fenway Park is located two blocks away, while the shops along Newbury Street are three blocks from the hotel.",
                "url" : "http://www.partner-site.com/hotelcommonwealth",
                "email" : "concierge@example.com",
                "phone" : "555-555-5555",
                "fax" : "555-555-5555",
                "room_types"  :
                    {
                        "Fenway Room" :
                            {
                                "url" : "http://www.partner-site.com/hotel_commonwealth/fenway_room",
                                "desc" : "One king bed with pillowtop mattress, Frette Italian linens, down bedding, multiple pillows. View of Fenway Park."
                            },
                        "Commonwealth Room" :
                            {
                                "url" : "http://www.partner-site.com/hotel_commonwealth/commonwealth_room",
                                "desc" : "One king bed with pillowtop mattress, Frette Italian linens, down bedding, multiple pillows. View of Commonwealth Avenue."
                            }
                    }
            }
        ]
}

Properties

Field Type Description
api_version number The version of the API that this response is using.
lang string Language code (see Supported Languages). The language of the response.
hotels InventoryHotel array Array of all inventory hotel objects supported by the partner. This is a full inventory list. Any hotels not included in an inventory response will be removed from the site.