Booking.com destination search

Body#

JSON object. Unknown fields are rejected with 422.

• querystring | nullmin length 2

  Destination as a guest would type it: a city, region, district, landmark or airport. Booking resolves free text itself; search_information.destination says what it chose. For an exact place use dest_id.

• dest_idinteger | null

  Booking's destination id from POST /v1/ota/booking/destinations (negative for most cities, e.g. Lisbon is -2167973).

• dest_typestring | null

  The dest_type that came with dest_id.

  One ofairportcitycountrydistricthotellandmarkregion

• urlstring | null

  A booking.com/searchresults.html link. Its destination, dates, guests, filters (nflt), sort (order), currency and language are used unless this request sets them.

• check_instring (date)required

  First night of the stay, YYYY-MM-DD. Taken from url when it has one.

• check_outstring (date) | null

  Departure date. An alternative to nights — if both are given, this wins.

• nightsintegerdefault 1min 1, max 90

  Length of stay. Ignored when check_out is supplied.

• adultsintegerdefault 2min 1, max 30

  Adults across all rooms.

• children_agesarray of integermax items 10

  One age (0-17) per child. Booking prices children by age.

• roomsintegerdefault 1min 1, max 30

  Rooms requested.

• currencystringdefault USD

  ISO 4217 code for the returned prices. Major currencies include AED, AUD, BRL, CAD, CHF, CNY, EUR, GBP, HKD, INR, JPY, KRW, MXN, NZD, SGD, USD; all 39 supported codes are listed in the enum.

  39 allowed values

  AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, CZK, DKK, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MXN, MYR, NOK, NZD, PEN, PHP, PLN, QAR, RON, SAR, SEK, SGD, THB, TRY, TWD, USD, VND, ZAR

• languagestringdefault en-us

  Booking's site language for names and labels (en-us, en-gb, fr, de, es, it, pt-pt, ja...).

• sortstringdefault popularity

  Booking's own sort orders: - popularity: Our top picks (Booking's default) - upsort_bh: Homes and apartments first - price: Price, lowest first - price_from_high_to_low: Price, highest first - review_score_and_price: Best reviewed and lowest price - class: Stars, highest first - class_asc: Stars, lowest first - class_and_price: Stars and price - distance_from_search: Distance from the searched place - bayesian_review_score: Top reviewed

  One ofbayesian_review_scoreclassclass_and_priceclass_ascdistance_from_searchpopularitypriceprice_from_high_to_lowreview_score_and_priceupsort_bh

• starsarray of string

  Star classes to keep: any of 1-5 and unrated.

• min_review_scoreinteger | null

  Booking's review filter: 6, 7, 8 or 9 and up. Booking also keeps properties with no reviews yet (review_score null).

  One of6789

• property_typesarray of string

  Booking's property types by name (Hotels, Apartments, Hostels, Resorts, Villas...) or numeric ht_id. Booking groups some types with others, so a row's own property_type can differ.

• price_mininteger | nullmin 0

  Lowest price per night, in currency.

• price_maxinteger | nullmin 1

  Highest price per night, in currency.

• free_cancellationbooleandefault false

  Only properties with a free-cancellation rate.

• no_prepaymentbooleandefault false

  Only properties that take no prepayment.

• meal_planstring | null

  Keep properties with this meal plan.

  One ofall_inclusiveall_mealsbreakfastbreakfast_and_dinnerbreakfast_and_lunchkitchen

• filtersstringdefault

  Advanced: Booking's own filter string (the nflt parameter of a search link, e.g. hotelfacility=107;di=929), added to the fields above.

• limitintegerdefault 25min 1, max 1000

  Properties to return, in Booking's order. Billed per started 25 returned.

• offsetintegerdefault 0min 0, max 1000

  Properties to skip: page on with pagination.next_offset. Booking lists about 1,000 properties per search at most.

• country_marketstring | null

  Visitor country (point of sale), two letters, e.g. GB. Booking and Agoda price by the visitor's country - measured 2026-10-03, Booking showed a GB visitor 321 USD where US and CA visitors saw 276 for the same night - so this asks for the price a visitor from that country sees. The answer's point_of_sale block says whether that country was actually served; when it was not, the price is the default market's. Omit for the previous behaviour.

  251 allowed values

  AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UK, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW