Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"destination",
"children"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"sort": {
"enum": [
"top-picks",
"distance",
"total",
"total-desc",
"reviews"
],
"type": "string",
"default": "top-picks",
"description": "Result order: top-picks, distance, total price ascending, total price descending, or guest reviews."
},
"rooms": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 1,
"description": "Number of rooms. Each room receives the default of 2 adults when adults is omitted."
},
"adults": {
"type": "integer",
"maximum": 16,
"minimum": 1,
"description": "Total adult guests. When omitted, RoomLast defaults to 2 adults per room."
},
"children": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "Total child guests; equals childrenAges.length."
},
"currency": {
"type": "string",
"default": "USD",
"maxLength": 3,
"minLength": 3
},
"timeZone": {
"type": "string",
"maxLength": 80,
"minLength": 3,
"description": "Optional IANA time-zone fallback for resolving relative stay dates; destination or property location takes precedence."
},
"amenities": {
"type": "array",
"items": {
"enum": [
"pool",
"parking",
"wifi",
"free-wifi",
"kitchen",
"fireplace",
"beachfront",
"washer",
"dryer",
"air-conditioning",
"tv",
"heating",
"family-friendly",
"kids-friendly",
"pet-friendly",
"hot-tub",
"free-breakfast",
"free-cancellation",
"laundry-in-unit",
"laundry-on-site",
"accessible",
"for-couples",
"solarium",
"long-term-deals",
"pay-over-time",
"accept-local"
],
"type": "string"
},
"maxItems": 12,
"description": "Amenities required in every result."
},
"dateIntent": {
"enum": [
"tonight"
],
"type": "string",
"description": "Relative stay intent. Tonight resolves check-in as the current local date and check-out as the following date."
},
"checkinDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Explicit check-in date in YYYY-MM-DD; paired with checkoutDate."
},
"destination": {
"type": "string",
"maxLength": 160,
"minLength": 2,
"description": "City, neighborhood, airport, landmark, or other broad destination."
},
"starRatings": {
"type": "array",
"items": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"maxItems": 5,
"description": "Exact accepted hotel star classifications."
},
"checkoutDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Explicit check-out date in YYYY-MM-DD; paired with checkinDate."
},
"childrenAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 17,
"minimum": 0
},
"default": [],
"maxItems": 8,
"description": "Age of every child at check-in. The array length must equal children."
},
"maximumPrice": {
"type": "number",
"description": "Maximum nightly price in the selected currency.",
"exclusiveMinimum": 0
},
"minimumPrice": {
"type": "number",
"minimum": 0,
"description": "Minimum nightly price in the selected currency."
},
"propertyTypes": {
"type": "array",
"items": {
"enum": [
"hotel",
"motel",
"resort",
"hostel",
"apartment",
"apart-hotel",
"extended-stay",
"condo",
"studio",
"house",
"townhome",
"guesthouse",
"bed-and-breakfast",
"villa",
"cabin",
"cottage",
"campground",
"rv",
"estate",
"boat",
"chateau",
"hotel-suites",
"corporate-apartment",
"farm-house",
"lodge",
"barn",
"mobile-home",
"house-boat",
"castle",
"mas",
"tower",
"mill",
"building"
],
"type": "string"
},
"maxItems": 12,
"description": "Accepted accommodation types, such as hotel, motel, resort, hostel, or apartment."
},
"minimumStarRating": {
"type": "number",
"maximum": 5,
"minimum": 1,
"description": "Minimum hotel star classification from 1 to 5; distinct from guest review score."
},
"minimumReviewScore": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Minimum guest review score out of 10; distinct from hotel star classification."
},
"freeCancellationOnly": {
"type": "boolean",
"default": false,
"description": "Whether results require free cancellation or refundable rates."
}
},
"additionalProperties": false
}