Sign in
Market intelligence

Search Booking.com properties

Changed on

Searches Booking.com stays for a destination and returns matching properties with rates, ratings, and availability.

<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/booking/search

Request

  • Base URL: https://api.fiber.ai
  • URL: https://api.fiber.ai/v1/booking/search
  • Auth: none declared

Request body

apiKeystring required

Your Fiber API key

querystring required

Destination to search (city, region, or landmark). For example, 'Dubrovnik' or 'Rome, Italy'.

checkInDatestring required

Check-in date for the stay.

checkOutDatestring required

Check-out date for the stay. Must be at least one calendar day after checkInDate.

hotelStarClassesinteger[] nullable

Filter to specific hotel star classes. This is a list of exact classes, not a range: [3, 5] returns only 3- and 5-star properties and excludes 4-star, so list every class you want (e.g. [3, 4, 5]).

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

Sort criterion for results. 'relevance' ranks by overall match. 'lowestPrice' sorts cheapest first. 'highestRating' sorts by guest review score. 'mostReviewed' uses Booking.com's top-reviewed ranking, which weighs review score by review volume. Omit to sort by relevance.

nextPageTokenstring nullable

Opaque pagination token from a prior search response's nextPageToken. Send it with the same search parameters that produced it. Omit (or pass null) to fetch the first page.

adultsinteger

Number of adult guests (at least 1). Total guests (adults + children) must not exceed 30.

childreninteger

Number of child guests. Total guests (adults + children) must not exceed 30.

childrenAgesinteger[]

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

roomsinteger

Number of rooms to search for. Defaults to 1.

currencyCodestring

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

languageCodestring nullable

Language for property names, descriptions, and labels. Pass a BCP-47 language tag such as 'en', 'en-US', 'fr', 'de', or 'es'. Omit for English.

Response

Default Response

advicestring[] nullable

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

Changes