Sign in

v4

latestOpenAPI 3.1.02026-08-012281296.0 MB
Market intelligence

Search hotels

Searches hotels and vacation rentals for a destination and returns matching properties with rates, ratings, and amenities.

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

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

post/v1/hotels/search

Request body

apiKeystring required

Your Fiber API key

querystring required

Destination or hotel search query (e.g. 'Hotels in Manhattan New York').

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.

sortBy'relevance' | 'lowestPrice' | 'highestRating' | 'mostReviewed' | 'null' nullable

Sort criterion for results. 'relevance' ranks by overall match. 'lowestPrice' sorts cheapest first. 'highestRating' sorts by guest rating. 'mostReviewed' sorts by review count. Omit to sort by relevance.

minRating'3.5' | '4.0' | '4.5' | 'null' nullable

Minimum guest rating filter. Omit to include all ratings.

nextPageTokenstring nullable

Opaque pagination token from a prior search response's nextPageToken. Omit (or pass null) to fetch the first page.

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.