Hotels

Search hotels

Find hotels by name, brand, city, city code or coordinates, with indicative nightly prices. Prices are for reference; quote get_rates. Refused with 422 when more than 30,000 hotels match.

search_hotels · Read-only · CLI: fortrip 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 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.