Get Hotel Image

The Get Hotel Image API returns the default image for a given Sabre hotel(s).

In detail: the API returns the default image url for a given Sabre hotel, along with the associated meta data including image type, caption, and last updated timestamp.

API Information

Target Audience
Sabre Travel Network
Current Version
v1.0.0
Authentication
Sessionless Token
Method/Endpoint
POST /v1.0.0/shop/hotels/image?mode=image HTTP/1.1

Ready to try the APIs?

Ready to get your hands dirty?

 Register Try the APIs

Ready to launch?

Ready to step up to the production level service? We're standing by to fit you for your spacesuit.

Request Production Key

Use Guidelines

Use of Sabre APIs must comply with the terms of your agreement with Sabre, its authorized purposes and the following use guidelines which may be amended by Sabre from time to time:

  • No caching allowed. In order to ensure that you have access to the most current visual content to display and reflect the property, you may not cache or store images or other visual content. Our hotel properties and chains are regularly updating their content in the Sabre Visual Content Management Platform (VCMP).
  • No onward distribution allowed. You may not redistribute the visual content or otherwise make it available to other parties not authorized under your Sabre Subscriber Agreement. The visual content may only be used in conjunction with your hotel shopping and booking activity in the Sabre system.
  • No compilations. You may not make or publish compilations of the visual content.
  • Please note that Sabre may change the content that is available at any time. Some content distributors and/or hotel companies may preclude Sabre from providing their licensed content to some or all third parties or limit the authorized usage. As such, Sabre does not provide images for all properties and the hotels affected may change from time to time.
  • Use of visual content of the APIs in violation of these use guidelines or the terms of your agreement with Sabre is misuse of the Sabre System and access may be terminated by Sabre.

The Get Hotel Image API provides access to image URLs in our Visual Content Management Platform (VCMP), which is a multi-sourced database of hotel property photos, including the associated metadata. Pictures are available in 5 sizes, categorized by OpenTravel's 23 Picture Categories (PIC) translated in up to 8 languages, and with free-text captions. The API also includes the "last updated" timestamp, and ordinals for image sequencing.

Image Sizes:

  • Original
  • Thumbnail
  • Small
  • Medium
  • Large

OpenTravel PIC name/code:

  • Exterior View - 1
  • Lobby view - 2
  • Pool view - 3
  • Restaurant - 4
  • Health Club - 5
  • Guest Room - 6
  • Suite - 7
  • Meeting Room - 8
  • Ballroom - 9
  • Golf Course - 10
  • Beach - 11
  • Spa - 12
  • Bar / Lounge - 13
  • Recreational - 14
  • Logo - 15
  • Basics - 16
  • Map - 17
  • Promotional - 18
  • Hotel News - 19
  • Miscellaneous - 20
  • Guest Room Amenity - 21
  • Property Amenity - 22
  • Business Center - 23

Languages for PIC name:

  • English (EN)
  • French (FR)
  • Spanish (ES)
  • Italian (IT)
  • German (DE)
  • Simplified Chinese (ZH)
  • Japanese (JA)
  • Russian (RU)

Free text caption (examples):

  • Enjoy the luxurious space of the Double Queen room
  • Whale watching from our beautiful infinity pool.

Note: This service is currently available in limited regions only (Americas and EMEA) and requires activation. Please contact your Sabre Account Representative for assistance.

JSON data format

Example: request and response

Sample request

This example demonstrates a request for: a hotel image Type of THUMBNAIL, a HotelCode of 1276, with captions in English (EN).

POST https://api.sabre.com/v1.0.0/shop/hotels/image?mode=image  HTTP/1.1
{
  "GetHotelImageRQ": {
    "HotelRefs": {
      "HotelRef": [
        {
          "HotelCode": "1276",
          "CodeContext": "Sabre"
        }
      ]
    },
    "ImageRef": {
      "Type": "THUMBNAIL",
      "CategoryCode": 3,
      "LanguageCode": "EN"
    }
  }
}

Sample response

{
  "GetHotelImageRS": {
    "ApplicationResults": {
      "Success": [
        {
          "timeStamp": "2016-05-16T08:04:59.611-05:00"
        }
      ]
    },
    "HotelImageInfos": {
      "HotelImageInfo": [
        {
          "HotelInfo": {
            "HotelCode": "1276",
            "CodeContext": "Sabre",
            "ChainCode": "YX",
            "Marketer": "SYNXIS",
            "Logo": "http://vcmp-hotels.cert.sabre.com/image/upload/t_vcmp_logo/hotel/l/synxis/SYNXIS.png"
          },
          "ImageItem": {
            "Id": "332055",
            "Ordinal": 16,
            "Format": "JPG",
            "LastModifedDate": "2016-04-08",
            "Image": {
              "Url": "http://vcmp-hotels.cert.sabre.com/image/upload/t_vcmp_thumb/hotel/i/1276/uvitpha0qioacl6c2tin.jpg",
              "Type": "THUMBNAIL",
              "Height": 100,
              "Width": 150
            },
            "Category": {
              "CategoryCode": 3,
              "Description": {
                "Text": [
                  {
                    "Language": "en",
                    "content": "Pool view"
                  }
                ]
              }
            },
            "AdditionalInfo": {
              "Info": [
                {
                  "Type": "CAPTION",
                  "Description": {}
                }
              ]
            }
          }
        }
      ]
    }
  },
  "Links": [
    {
      "rel": "self",
      "href": "http://api.sabre.com/v1.0.0/shop/hotels/image?mode=image"
    },
    {
      "rel": "linkTemplate",
      "href": "http://api.sabre.com/<version>/shop/hotels/image?mode=<mode>"
    }
  ]
}

Errors

A general HTTP status code is always returned. See the status codes and errors page for other common status codes and errors.

400 BAD REQUEST

The request was not valid.
The service does not support the data used in the request. For example, origin or destination in the request is not a valid IATA airport code.

If you receive this error:

{ status: "NotProcessed" type: "Validation" errorCode: "ERR.2SG.CLIENT.INVALID_REQUEST" timeStamp: "2016-05-20T11:43:34.599-05:00"
  message: "Request is invalid: Request payload is missing or it is not supported by the requested service" }

Ensure you:

  • have specified a content type header with a value of 'application/json'
  • are sending a JSON document in the HTTP POST's request body

Docs Navigation