The GetPropertyData query is the primary hotel content retrieval service within the Merchandising API.
It allows travel buyers to retrieve hotel-level merchandising and descriptive content. The GetPropertyData query returns hotel-level content only. Room-level content must be retrieved separately using the GetPropertyRoomData query.
Request Example
Query Variables
{
"limit": 1,
"resumeKey": null,
"since": null,
"updateTypes": null,
"propertyIds": null
}Request
query GetPropertyData($limit: Int, $resumeKey: String, $since: DateTime, $updateTypes: [String], $propertyIds: [Long], $cityId: Int, $stateCode: String, $countryCode: String) {
GetPropertyData(
limit: $limit
resumeKey: $resumeKey
since: $since
updateTypes: $updateTypes
propertyIds: $propertyIds
cityId: $cityId
stateCode: $stateCode
countryCode: $countryCode
) {
meta {
dataLoadType
timestamp
totalCount
newCount
updateCount
disableCount
unchangedCount
resumeKey
}
properties {
propertyId
propertyName
starRating
defaultCurrencyCode
maxRoomsBookable
numberOfRooms
numberOfFloors
address {
line1
line2
cityId
city
state
stateCode
postalCode
country
countryCode
}
contact {
phone
fax
email
website
}
location {
latitude
longitude
}
amenities {
code
name
}
images {
url
type
description
}
currencies {
code
name
}
languages {
code
name
}
mappingProviders {
mappingProvider
mappingCode
}
bedtypes {
code
name
}
checkInPolicy
checkInTime
checkOutTime
timeZone
longDescription
shortDescription
adultAge
defaultLanguage
adultOnly
updateType
}
}
}
Response Example
{
"data": {
"GetPropertyData": {
"meta": {
"dataLoadType": "INCREMENTAL",
"timestamp": "2026-09-11T09:21:59Z",
"totalCount": 1,
"newCount": 0,
"updateCount": 0,
"disableCount": 0,
"unchangedCount": 1,
"resumeKey": "MjEzNTo0"
},
"properties": [
{
"propertyId": 129410,
"propertyName": "SAHARA Las Vegas",
"starRating": 4.0,
"defaultCurrencyCode": "USD",
"maxRoomsBookable": null,
"numberOfRooms": 1615,
"numberOfFloors": 26,
"address": {
"line1": "2535 Las Vegas Blvd S",
"line2": null,
"cityId": 47,
"city": "Las Vegas",
"state": "Nevada",
"stateCode": "NV",
"postalCode": "89109",
"country": "United States",
"countryCode": "US"
},
"contact": {
"phone": "702-761-7000",
"fax": null,
"email": null,
"website": null
},
"location": {
"latitude": "36.1422754",
"longitude": "-115.1562447"
},
"amenities": [],
"images": null,
"currencies": [
{
"code": "USD",
"name": "US Dollar"
}
],
"languages": [
{
"code": "en",
"name": "English"
}
],
"mappingProviders": [
{
"mappingProvider": "GIATA",
"mappingCode": "6414"
}
],
"bedtypes": [],
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.",
"checkInTime": "16:00",
"checkOutTime": "11:00",
"timeZone": "America/Los_Angeles",
"longDescription": "\nProperty Location \nWith a stay at SLS Las Vegas a Tribute Portfolio Resort, you'll be centrally located in Las Vegas, convenient to Las Vegas Country Club and Las Vegas Convention Center. This 4-star hotel is within close proximity of Guardian Angel Cathedral and Little White Wedding Chapel.\nRooms \nMake yourself at home in one of the 1327 air-conditioned rooms featuring flat-screen televisions. Complimentary wireless Internet access keeps you connected, and satellite programming is available for your entertainment. Private bathrooms with showers feature rainfall showerheads and designer toiletries. Conveniences include desks and a turndown service, as well as phones with free local calls.\nAmenities \nRelax at the full-service spa, where you can enjoy massages, body treatments, and facials. Before a night out at the casino, the 2 outdoor swimming pools are a perfect way to relax and recharge. This hotel also features complimentary wireless Internet access, concierge services, and gift shops/newsstands.\nDining \nGrab a bite to eat at one of the hotel's 6 restaurants and 2 coffee shops/cafes, or stay in and take advantage of 24-hour room service. Relax with a refreshing drink from a poolside bar or one of the 2 bars/lounges.\nBusiness, Other Amenities \nFeatured amenities include a 24-hour business center, express check-out, and dry cleaning/laundry services. Planning an event in Las Vegas? This hotel has 30000 square feet (2787 square meters) of space consisting of a conference center and meeting rooms. Free valet parking is available onsite.",
"shortDescription": "SAHARA Las Vegas embodies the bold, iconic spirit of Vegas. Incidentals - A major credit card is required upon check-in and will be authorized for room charges, taxes, resort fees, and a $50.00 incidental deposit per day. Any unused incidental funds may take up to 5 business days to be released by your financial institution.\n\noffers FREE Self Parking and Free Valet.\nBazaar Meat by José Andrés restaurant has been closed.\n\nPlease note that SAHARA Las Vegas is a cannabis-free hotel and casino. In compliance with Nevada law and federal regulations, the possession, use or consumption of cannabis in any form is strictly prohibited on our premises, including guest rooms, public areas and casino floors. Violations may result in eviction and additional penalties, with state fines ranging from $250 - $700.\n\nPlease note that the Amina Spa located at the Alexandria Tower is temporarily closed. ",
"adultAge": 21,
"defaultLanguage": "en",
"adultOnly": false,
"updateType": null
}
]
}
}
}Query Parameters
GetPropertyData Variables
| Variable
|
Type | Required | Description |
|---|---|---|---|
| since | DateTime | No | Returns hotels updated after the specified UTC timestamp.
|
|
propertyIds
|
Long | No | Returns specific hotel(s).
|
|
countryCode
|
String | No | Returns hotels based in requested countries. Note: Please talk to your TAM representative at Hotel Trader to enable this. To get list of city, stateCode and countryCode please check respective endpoints.
|
|
countryCode +
stateCode
|
String, String
|
No | Returns hotels based in requested state + country. Cannot be used with state alone. Note: Please talk to your TAM representative at Hotel Trader to enable this. To get list of city, stateCode and countryCode please check respective endpoints.
|
|
cityId
|
Int | No | Returns hotels based in requested city. To get list of city, stateCode and countryCode please check respective endpoints.
|
|
limit
|
Int | Yes | Maximum number of hotels returned in a single response page.
|
|
resumeKey
|
String
|
No | Pagination token returned from the previous response.
|
|
updateTypes
|
[String] | No | Filters results by update type.
|
Update Types
UpdateTypes filter is coming soon! Supported values for updateTypes may include:
| Value | Description |
|---|---|
|
NEW
|
Newly created hotel records
|
|
UPDATED
|
Existing hotels with updated content
|
|
DISABLED
|
Hotels disabled from distribution
|
Pagination
The API uses cursor-based pagination via resumeKey.
First Request
For the initial request:
"resumeKey":null
Next Page Request
Use the resumeKey returned in the previous response:
"resumeKey":"Mjk1OjI="
If no resumeKey is returned, there are no more pages available.
Request Example
Query Variables
{
"propertyIds": [126913],
"limit": 1
}Request
query GetPropertyData($propertyIds: [Long]) {
GetPropertyData(propertyIds: $propertyIds) {
meta {
dataLoadType
timestamp
totalCount
newCount
updateCount
disableCount
unchangedCount
resumeKey
}
properties {
propertyId
propertyName
starRating
defaultCurrencyCode
maxRoomsBookable
numberOfRooms
numberOfFloors
address {
line1
line2
city
state
stateCode
postalCode
country
countryCode
}
contact {
phone
fax
email
website
}
location {
latitude
longitude
}
currencies {
code
name
}
languages {
code
name
}
mappingProviders {
mappingProvider
mappingCode
}
checkInPolicy
checkInTime
checkOutTime
timeZone
longDescription
shortDescription
adultAge
defaultLanguage
adultOnly
}
}
}Response Example
{
"data": {
"GetPropertyData": {
"meta": {
"dataLoadType": "FULL",
"timestamp": "2026-08-19T12:44:44Z",
"totalCount": 1,
"newCount": 0,
"updateCount": 1,
"disableCount": 0,
"unchangedCount": 0,
"resumeKey": null
},
"properties": [
{
"propertyId": 126913,
"propertyName": "THE NEW YORKER HOTEL BY LOTTE HOTELS",
"starRating": 4.0,
"defaultCurrencyCode": "USD",
"maxRoomsBookable": null,
"numberOfRooms": 1050,
"numberOfFloors": 40,
"address": {
"line1": "481 8th Avenue & 34th Street",
"line2": "",
"city": "New York",
"state": "New York",
"stateCode": "NY",
"postalCode": "10001",
"country": "US",
"countryCode": "US"
},
"contact": {
"phone": "1-212-971-0101",
"fax": "--",
"email": null,
"website": "www.newyorkerhotel.com"
},
"location": {
"latitude": "40.75219",
"longitude": "-73.99346400000002"
},
"currencies": [
{
"code": "USD",
"name": "US Dollar"
}
],
"languages": [
{
"code": "en",
"name": "English"
}
],
"mappingProviders": [
{
"mappingProvider": "Vervotech",
"mappingCode": "39519752"
}
],
"checkInPolicy": "Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.",
"checkInTime": "16:00",
"checkOutTime": "12:00",
"timeZone": "America/New_York",
"longDescription": "Immerse yourself in the history of NYC at our full-service business hotel in Midtown Manhattan. Located on 8th avenue, THE NEW YORKER HOTEL BY LOTTE HOTELS is a premier hotel with the unique blend of stylish Art deco design and urban flair. Designed with the business traveler in mind, our hotel offers thoughtful amenities and comfortable rooms - ideal for work, play and relaxation.",
"shortDescription": "Located on 8th avenue, THE NEW YORKER HOTEL BY LOTTE HOTELS is a premier hotel with the unique blend of stylish Art deco design and urban flair.",
"adultAge": 21,
"defaultLanguage": "en",
"adultOnly": false
}
]
}
}
}Response Metadata (meta)
| Field | Type | Description |
|---|---|---|
| dataLoadType | String | Type of load returned (FULL or INCREMENTAL). |
| timestamp | DateTime | UTC timestamp when the response was generated. |
| totalCount | Int | Total number of hotel records in the response. |
| newCount | Int | Number of newly added hotels. |
| updateCount | Int | Number of updated hotels. |
| disableCount | Int | Number of disabled hotels. |
| unchangedCount | Int | Number of unchanged hotels. |
| resumeKey
|
String
|
Pagination token for retrieving the next page.
|
Hotel Object
Basic Information
| Field | Type | Description |
|---|---|---|
| propertyId | Long | Unique Hotel Trader property identifier. |
| propertyName | String | Hotel name. |
| starRating | Float | Hotel star rating. |
| defaultCurrencyCode | String | Default currency used by the property. |
| maxRoomsBookable | Int | Maximum rooms allowed per booking. |
| numberOfRooms | Int | Total number of rooms in the hotel. |
| numberOfFloors | Int | Total number of floors in the hotel. |
Address Object
| Field | Type | Description |
|---|---|---|
| line1 | String | Primary street address. |
| line2 | String | Secondary address line. |
| cityId | Int | cityId from geoData. |
| city | String | City name. |
| state | String | State or province name. |
| stateCode | String | State or province code. |
| postalCode | String | ZIP or postal code. |
| country | String | Country code or country name. |
| countryCode | String | ISO country code. |
Contact Object
| Field | Type | Description |
|---|---|---|
| phone | String | Hotel contact phone number. |
| fax | String | Hotel fax number. |
| String | Hotel contact email address. | |
| website | String | Hotel website URL. |
Location Object
| Field | Type | Description |
|---|---|---|
| latitude | Decimal | Hotel latitude coordinate. |
| longitude | Decimal | Hotel longitude coordinate. |
Currency Object
| Field | Type | Description |
|---|---|---|
| code | String | ISO currency code. |
| name | String | Currency display name. |
Language Object
| Field | Type | Description |
|---|---|---|
| code | String | ISO language code. |
| name | String | Language display name. |
Mapping Providers[]
| Field | Type | Description |
|---|---|---|
| mappingProvider | String | Mapping provider name (e.g. GIATA, Vervotech, TravelBuyer). Contact your TAM representative at Hotel Trader to inform them which ID you would like to receive. In case you would like to receive your own IDs you will have to provide us your entire portfolio along with its metadata in a specific CSV file format. |
| mappingCode | String | Provider-specific hotel mapping identifier. |
Policy & Timing Fields
| Field | Type | Description |
|---|---|---|
| checkInPolicy | String | Check-in rules or deposit requirements. |
| checkInTime | String | Hotel check-in time. |
| checkOutTime | String | Hotel check-out time. |
| timeZone | String | Hotel local timezone. |
Description Fields
| Field | Type | Description |
|---|---|---|
| longDescription | String | Full hotel description. |
| shortDescription | String | Shortened hotel description. |
Guest Policy Fields
| Field | Type | Description |
|---|---|---|
| adultAge | Int | Minimum age considered an adult by the property. |
| defaultLanguage | String | Default hotel content language. |
| adultOnly | Boolean | Indicates whether the property is adults-only. |