> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dev.gojinko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# jinko hotel-search

> Search live hotel inventory and rates

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

```bash theme={null}
jinko hotel-search [options]
```

## Options

| Flag                         | Required | Description                                                                                                                                   | Default |
| ---------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `--query <text>`             | No       | free-text destination (city, region, POI) — Mode B. JSON: `query`.                                                                            |         |
| `--city-name <name>`         | No       | city name (e.g. "Paris") — Mode B destination, or Mode A lookup scope when combined with --hotel-name. JSON: `city_name`.                     |         |
| `--country-code <code>`      | No       | ISO 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>`      | No       | latitude for geo-radius search — Mode B. JSON: `latitude`.                                                                                    |         |
| `--longitude <longitude>`    | No       | longitude for geo-radius search — Mode B. JSON: `longitude`.                                                                                  |         |
| `--radius-km <km>`           | No       | search radius in km (default 5, max 50) — Mode B. JSON: `radius_km`.                                                                          |         |
| `--place-id <id>`            | No       | Google Places ID or upstream place identifier — Mode B. JSON: `place_id`.                                                                     |         |
| `--hotel-ids <ids...>`       | No       | re-shop specific hotel IDs — Mode A. JSON: `hotel_ids`.                                                                                       |         |
| `--hotel-name <name>`        | No       | look up a specific hotel by name — Mode A. Pair with --city-name and --country-code to narrow the lookup scope.                               |         |
| `--checkin <date>`           | Yes      | check-in date (YYYY-MM-DD). JSON: `checkin`.                                                                                                  |         |
| `--checkout <date>`          | Yes      | check-out date (YYYY-MM-DD). JSON: `checkout`.                                                                                                |         |
| `--adults <n>`               | No       | number of adults (shorthand). JSON: `adults`.                                                                                                 | `"2"`   |
| `--children <ages...>`       | No       | children ages (shorthand, e.g. 5 7). JSON: `children`.                                                                                        |         |
| `--rooms <n>`                | No       | number of rooms (shorthand). JSON: `rooms`.                                                                                                   |         |
| `--currency <code>`          | No       | ISO 4217 currency code (default USD). JSON: `currency`.                                                                                       |         |
| `--guest-nationality <code>` | No       | guest nationality (ISO 3166-1 alpha-2). JSON: `guest_nationality`.                                                                            |         |
| `--min-rating <n>`           | No       | minimum guest review rating (0-10). JSON: `min_rating`.                                                                                       |         |
| `--star-rating <n>`          | No       | minimum star rating (1-5). JSON: `min_star_rating`.                                                                                           |         |
| `--max-star-rating <n>`      | No       | maximum star rating (1-5). JSON: `max_star_rating`.                                                                                           |         |
| `--min-reviews <n>`          | No       | minimum number of reviews. JSON: `min_reviews`.                                                                                               |         |
| `--max-results <n>`          | No       | maximum hotels to return per page (default 50). JSON: `max_results`.                                                                          |         |
| `--offset <n>`               | No       | pagination offset — skip this many hotels at the upstream search (default 0). JSON: `offset`.                                                 |         |
| `--city <name>`              | No       | DEPRECATED: use --city-name.                                                                                                                  |         |
| `--country <code>`           | No       | DEPRECATED: use --country-code.                                                                                                               |         |
| `--lat <latitude>`           | No       | DEPRECATED: use --latitude.                                                                                                                   |         |
| `--lng <longitude>`          | No       | DEPRECATED: use --longitude.                                                                                                                  |         |
| `--radius <km>`              | No       | DEPRECATED: use --radius-km.                                                                                                                  |         |
| `--nationality <code>`       | No       | DEPRECATED: use --guest-nationality.                                                                                                          |         |
| `--stars <n>`                | No       | DEPRECATED: use --star-rating.                                                                                                                |         |
| `--max-stars <n>`            | No       | DEPRECATED: use --max-star-rating.                                                                                                            |         |

## Examples

```bash theme={null}
# 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
```