Skip to content

Overview

Retrieve everything static about a property and its inventory — the paid Partner Content API.

Content is the single source of truth for anything that does not change per search: names, descriptions, addresses, galleries, room detail, amenities, policies, rate plans and cancellation terms. The pricing endpoints deliberately do not return it, so fetch it here, cache it per property, and refresh it by sending your stored cache_token back (see known_versions); NOT_MODIFIED means your copy is current. last_update on a search result is only a coarse hint.

Already hold a copy? Send the cache_token you were given back in known_versions and any property that has not changed returns CONTENT_STATUS_NOT_MODIFIED with no content, so a nightly catalogue sync transfers only what actually moved. It does not reduce your bill — you are charged per call, not per property — but it cuts response size and the work on both ends. See known_versions.

Descriptions come back in English plus the language you request, so you always have a usable fallback when a property has not translated a field.

One call, one shape. By default you get the property’s basic identity; ask for more with include and it arrives in the same response rather than costing you another round trip. Billing does not change with breadth: 1 unit per property returned, whatever you included.

Requires an authenticated token with INVENTORY:READ on the account you pass.