Skip to main content
Search live hotel inventory and nightly rates for a destination and stay window. It handles requests like “three nights in Lisbon next weekend for two adults” or “family room in Rome with one child in August”. Each result includes an htl_* offer token you can hand to the trip tool to start a booking.

​
Usage

jinko hotel-search [options]

​
Options

FlagRequiredDescriptionDefault
--query <text>Nofree-text destination (city, region, POI) — Mode B. JSON: query.
--city-name <name>Nocity name (e.g. “Paris”) — Mode B destination, or Mode A lookup scope when combined with —hotel-name. JSON: city_name.
--country-code <code>NoISO 3166-1 alpha-2 country code (e.g. fr) — Mode B destination, or Mode A lookup scope when combined with —hotel-name. JSON: country_code.
--latitude <latitude>Nolatitude for geo-radius search — Mode B. JSON: latitude.
--longitude <longitude>Nolongitude for geo-radius search — Mode B. JSON: longitude.
--radius-km <km>Nosearch radius in km (default 5, max 50) — Mode B. JSON: radius_km.
--place-id <id>NoGoogle Places ID or upstream place identifier — Mode B. JSON: place_id.
--hotel-ids <ids...>Nore-shop specific hotel IDs — Mode A. JSON: hotel_ids.
--hotel-name <name>Nolook up a specific hotel by name — Mode A. Pair with —city-name and —country-code to narrow the lookup scope.
--checkin <date>Yescheck-in date (YYYY-MM-DD). JSON: checkin.
--checkout <date>Yescheck-out date (YYYY-MM-DD). JSON: checkout.
--adults <n>Nonumber of adults (shorthand). JSON: adults."2"
--children <ages...>Nochildren ages (shorthand, e.g. 5 7). JSON: children.
--rooms <n>Nonumber of rooms (shorthand). JSON: rooms.
--currency <code>NoISO 4217 currency code (default USD). JSON: currency.
--guest-nationality <code>Noguest nationality (ISO 3166-1 alpha-2). JSON: guest_nationality.
--min-rating <n>Nominimum guest review rating (0-10). JSON: min_rating.
--star-rating <n>Nominimum star rating (1-5). JSON: min_star_rating.
--max-star-rating <n>Nomaximum star rating (1-5). JSON: max_star_rating.
--min-reviews <n>Nominimum number of reviews. JSON: min_reviews.
--max-results <n>Nomaximum hotels to return per page (default 50). JSON: max_results.
--offset <n>Nopagination offset — skip this many hotels at the upstream search (default 0). JSON: offset.
--city <name>NoDEPRECATED: use —city-name.
--country <code>NoDEPRECATED: use —country-code.
--lat <latitude>NoDEPRECATED: use —latitude.
--lng <longitude>NoDEPRECATED: use —longitude.
--radius <km>NoDEPRECATED: use —radius-km.
--nationality <code>NoDEPRECATED: use —guest-nationality.
--stars <n>NoDEPRECATED: use —star-rating.
--max-stars <n>NoDEPRECATED: use —max-star-rating.

​
Examples

# Paris, 2 adults, 3 nights
jinko hotel-search --query "Paris" --checkin 2026-07-15 --checkout 2026-07-18 --adults 2

# By city + country, filtered
jinko hotel-search --city-name "Barcelona" --country-code ES \
  --checkin 2026-08-01 --checkout 2026-08-05 --adults 2 \
  --min-rating 8 --star-rating 4