Property Content

Hilton provides the Content API for pulling detailed property data that partners require, including room type data. Partners may choose to call the API based on their needs (once daily/weekly/etc.) so that latest content is available to them. Images and media are supported through IcePortal and Leonardo.

NOTE - This API is not meant to handle high volume and should not be called as part of a guest’s shopping flow. The static property data delivered through this API is meant to be stored by the partner.

The Propsextracts endpoint returns the full list of active Hilton properties along with property details for each.

If you are interested in the Content API please reach out to your Hilton contact who can start the access process.

Download Content API Swagger here

Customizing request messages

Property content calls can be customized in two ways: Limit, Offset

  1. Limit (Recommended) – sets how many records to return in the response
    1. Default limit=100
    2. Recommended limit=50, if faster response time is needed, it recommended to set limit=10
    3. NOTE: depending on response size, fewer records may be returned. Always confirm the value using the response header
  2. Offset (Required) – set where to start processing records
    1. Offset changes incrementally from 0 based on the Limit until all records have been retrieved. For example, if limit=50 & offset=0 returns first 50 records, then offset=50 returns the next 50 records, offset=100 returns the following 50 records, and so on.
    2. NOTE: when using the Content-Range response header, the next offset should be set to the end record number plus one; example, if the header is Content-Range : items 0-99/11092, next request should use offset=100.

Customizing response messages

Property content responses can be customized using: Sort

  1. Sort – allows records in the response to be sorted in a specific order
    1. Sort property codes in ascending order (A-Z)
      GET https://kapip.hilton.io/hospitality-partner/v2/content/propsextracts?sort=propCode:asc

Ready to try it out?

Once you have been given access to Hilton STG environment you can use the below calls to evaluate the property content.

Please note that responses will be returned as HTTP 206 partial content responses due to large response size. Multiple API calls will need to be made to fetch complete response.

  • All data for all properties -
    https://kapip-s.hilton.io/hospitality-partner/v2/content/propsextracts
  • All data for one property -
    https://kapip-s.hilton.io/hospitality-partner/v2/content/propsextracts?propCode=SFOSF
  • Data for Hilton properties that support child-based pricing, along with specific age ranges -
    https://kapip-s.hilton.io/hospitality-partner/v2/content/propsextracts?includes=props,props.propDetail,props.propDetail.childPricing,props.propDetail.childPricing.childAgeRanges,props.propDetail.propertyAttributes&fields=props.propCode,props.propDetail.childPricing.defaultAge,props.propDetail.childPricing.adultAge,props.propDetail.childPricing.updatedTime,props.propDetail.childPricing.childAgeRanges[].startChildAge,props.propDetail.childPricing.childAgeRanges[].endChildAge,props.propDetail.propertyAttributes.hasAgeBasedPricing&props.propDetail.propertyAttributes.hasAgeBasedPricing=true

If you require only a few details from the property data – or need examples not covered above – the API call can be customized to limit your response to those fields. Please reach out to our Distribution Platforms team with the details of what you need, and we will assist with creating a custom request message.

For additional information on pulling property content, please see Obtain Property Information | Hilton Dev Portal for documentation.