Market intelligence

Get hotel property details

Changed on

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

  • Base URL
    https://api.fiber.ai
  • URL
    https://api.fiber.ai/v1/hotels/property
  • Auth
    none declared

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

  • 4002aa81d4fbRevision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became optional for the status

    • info

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

  • fda5277ff34fRevision changes
    • info

      endpoint added