HotelByNameRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/flightpowers-com/json-schema/flightpowers-com-hotel-by-name-request-schema.json",
  "title": "HotelByNameRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/flightpowers-com-openapi.json#/components/schemas/HotelByNameRequest",
  "type": "object",
  "required": [
    "hotel_name",
    "checkin_date",
    "checkout_date"
  ],
  "properties": {
    "hotel_name": {
      "type": "string",
      "description": "Free-text hotel name, e.g. `Kremlin Palace`."
    },
    "checkin_date": {
      "type": "string",
      "format": "date"
    },
    "checkout_date": {
      "type": "string",
      "format": "date"
    },
    "area": {
      "type": "string",
      "description": "City/region to disambiguate generic hotel names, e.g. `Budapest`. Search uses `<hotel_name>, <area>`; name matching still uses only `hotel_name`."
    },
    "adults": {
      "type": "integer",
      "default": 2
    },
    "children": {
      "type": "integer",
      "default": 0
    },
    "currency": {
      "type": "string",
      "default": "USD"
    },
    "proxy_country": {
      "type": "string",
      "description": "Two-letter country code to route the request through a residential proxy in that country (e.g. `us`, `de`, `il`). Booking.com shows different prices to different markets; this is how you observe them - the basis for rate-parity and geo-pricing monitoring. When omitted, the request uses the full global residential pool."
    },
    "free_cancellation": {
      "type": "boolean",
      "default": false
    }
  }
}