Hotels

Search hotels

Find hotels by name/brand/city text (query), catalogue cityCode or coordinates (near), with per-night prices for the dates in currency (CNY by default, or USD). Those prices come from the supplier's minimum-price feed, not live rates; get_hotel_rates returns the bookable price. facilities must match catalogue names exactly. Refused (422) when more than 30,000 hotels match: narrow the search.

search_hotels · Read-only · CLI: fortrip hotels search

Input

querystring

Hotel name, brand or city to search for. Provide at least one of query, cityCode or near.1–128 chars

cityCodeinteger

Catalogue city code, as returned in hotels[].cityCode.> 0

nearobject

Search around a point.

near.latnumberrequired

Latitude.-90–90

near.lngnumberrequired

Longitude.-180–180

near.radiusKmnumberrequired

Radius in kilometres.> 0, ≤ 200

starMinnumber

Lowest star rating to include.0–5

starMaxnumber

Highest star rating to include.0–5

facilitiesstring[]

Facilities every hotel must have. Names must match the catalogue exactly (case-insensitive), e.g. Swimming pool, Parking.1–10 items · each 1–64 chars

checkInstringrequired

Check-in date, yyyy-MM-dd.

checkOutstringrequired

Check-out date, yyyy-MM-dd. Stays are 1 to 15 nights.

currency"CNY" | "USD"

Currency to show prices in. Prices are converted from the supplier's at Stripe's exchange rate; the response's fx says how.default "CNY"

priceMinnumber

Lowest average nightly price, in currency. Applied to indicative prices.≥ 0

priceMaxnumber

Highest average nightly price, in currency.> 0

sortBy"recommended" | "price-asc" | "price-desc" | "star-desc" | "distance"

Result order. recommended sorts by distance with near, by relevance with query, otherwise by catalogue weight. distance requires near.default "recommended"

pageinteger

Page number.1–100 · default 1

pageSizeinteger

Hotels per page.1–50 · default 20

Output

Returns the Search result object as structuredContent. Errors are described in the overview.