Agoda Hotel Room Rates by URL

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Full Agoda hotel page URL carrying the stay parameters (checkIn, los, adults, rooms, children, currencyCode)."
    },
    "proxyCountry": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Two-letter country code to route the request through; affects the prices and availability Agoda shows (default 'th')."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "hotel_name",
          "arrival_date",
          "nights",
          "price",
          "currency",
          "cancellable",
          "vat_included",
          "room_name",
          "max_persons",
          "meal_included",
          "have_promotion",
          "promotion",
          "rate_plan_name",
          "rate_plan_breakdown",
          "is_sold_out",
          "quote_captured_at"
        ],
        "properties": {
          "price": {
            "type": "number",
            "description": "Total rate for the whole stay, in the unit named by `currency`."
          },
          "nights": {
            "type": "integer",
            "description": "Length of stay, in nights."
          },
          "currency": {
            "type": "string",
            "description": "A currency SYMBOL as Agoda displays it (e.g. 'S$'), not an ISO 4217 code -- confirmed against both fixtures."
          },
          "promotion": {
            "type": "object",
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Promotion campaign name."
              },
              "discount_value": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "discount_percentage": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "description": "Always present, but every field was `null` on every entry in both captured fixtures (neither fixture's stay had an active promotion) -- shape when `have_promotion` is true is unconfirmed.",
            "additionalProperties": true
          },
          "room_name": {
            "type": "string",
            "description": "The room type's own name."
          },
          "hotel_name": {
            "type": "string",
            "description": "The hotel's own name, as Agoda's page displays it."
          },
          "cancellable": {
            "type": "boolean"
          },
          "is_sold_out": {
            "type": "boolean"
          },
          "max_persons": {
            "type": "integer"
          },
          "arrival_date": {
            "type": "string",
            "description": "Check-in date, e.g. '2026-10-15'."
          },
          "vat_included": {
            "type": "boolean",
            "description": "Whether `price` already includes VAT."
          },
          "meal_included": {
            "type": "boolean",
            "description": "Whether a meal plan is bundled in."
          },
          "have_promotion": {
            "type": "boolean"
          },
          "rate_plan_name": {
            "type": "string",
            "description": "Usually matches `room_name`."
          },
          "quote_captured_at": {
            "type": "string",
            "description": "Timestamp this price quote was captured, ISO 8601 -- Agoda rates change frequently, so use this to judge how fresh a quoted price is."
          },
          "rate_plan_breakdown": {
            "type": "object",
            "required": [
              "meal_plan",
              "cancellation_policy",
              "refundability",
              "inclusions"
            ],
            "properties": {
              "meal_plan": {
                "type": "string",
                "description": "e.g. 'Good breakfast included', or an empty string when none."
              },
              "inclusions": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Free-text room/rate perks, e.g. 'Free WiFi', 'Non-smoking'."
              },
              "refundability": {
                "type": "string",
                "description": "Observed values: 'Refundable', 'Non-Refundable'."
              },
              "cancellation_policy": {
                "type": "string",
                "description": "Empty string on every entry observed in both fixtures."
              }
            },
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per room-rate-plan combination Agoda returned for the stay -- 40 entries on a well-known Singapore hotel with normal availability, 15 on the same hotel with a smaller available inventory for different dates. Every field below was present on every entry in both fixtures."
    }
  },
  "description": "Room rate plans for the requested Agoda hotel/stay, wrapped as `{results: [...]}` -- no bare top-level array.",
  "additionalProperties": true
}