--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. | |
--max-budget-per-night <amount> | No | keep only hotels whose cheapest per-night price (per room, in the request currency) fits this budget; the search scans deeper automatically when few hotels fit. JSON: max_budget_per_night. | |
--user-intent <text> | No | the end user’s request in their own words, forwarded to Jinko for observability and relevance (avoid PII). Env fallback: JINKO_USER_INTENT. JSON: intent.user_intent. | |
