Sign in
Market intelligence

Get hotel property details

Retrieves full details for a single hotel or vacation rental, including amenities, images, and booking offers.

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> 2 credits per property lookup <span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

post/v1/hotels/property

Request body

apiKeystring required

Your Fiber API key

propertyTokenstring required

Opaque identifier for a specific hotel or vacation rental. Obtain it from the propertyToken of a result returned by the hotel search endpoint (POST /v1/hotels/search).

checkInDatestring required

Check-in date for the stay.

checkOutDatestring required

Check-out date for the stay.

adultsinteger

Number of adult guests (at least 1). Total guests (adults + children) must not exceed 6 for hotels or 10 for vacation rentals.

childreninteger

Number of child guests. Total guests (adults + children) must not exceed 6 for hotels or 10 for vacation rentals.

childrenAgesinteger[]

Ages of each child guest. Must contain exactly children entries when children is greater than zero.

currencyCodestring

ISO 4217 currency code for prices in the response (e.g. 'EUR', 'GBP', 'CAD'). Case-insensitive. Defaults to USD.

searchMarketCountryCodestring

ISO 3166-1 alpha-3 country code that sets the search market (e.g. 'GBR', 'BRA'). This affects regional pricing and availability. Case-insensitive.

languageCodestring

Language for results such as property names and amenity labels. Pass a BCP-47 language tag such as 'en', 'en-US', 'pt-BR', 'zh-CN', 'ja', 'ko', 'fr', 'de', or 'es'. Defaults to en.

Response

Default Response

advicestring[] nullable

Tips, recommendations, and suggestions for using this API effectively.

Changes

Changed in 2 of the 10 revisions of this API.22

  • 4002aa81d4fb21See the full diff
    • ▲

      the response property advice became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property advice became optional for the status 200

      response-property-became-optional

    • ○

      the advice response's property default value was removed for the status 200

      response-property-default-value-removed

  • fda5277ff34f1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog