skyscanner.hotel.search
View connectorSearch guest hotel prices and provider offers
POST /v1/operations/skyscanner.hotel.searchRestricted access · live-read. Examples are illustrative and do not execute requests.
Inputs
| Parameter | Example type | Example value |
|---|---|---|
| destination_entity_id | string | "27544008" |
| checkin_date | string | "2026-11-03" |
| checkout_date | string | "2026-11-05" |
| adults | number | 2 |
| rooms | number | 1 |
| currency | string | "USD" |
Example input
{
"destination_entity_id": "27544008",
"checkin_date": "2026-11-03",
"checkout_date": "2026-11-05",
"adults": 2,
"rooms": 1,
"currency": "USD"
}Input schema
{
"$id": "https://priv-platform.local/connectors/skyscanner/hotel-search.input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"adults": {
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"checkin_date": {
"format": "date",
"type": "string"
},
"checkout_date": {
"format": "date",
"type": "string"
},
"child_ages": {
"items": {
"maximum": 17,
"minimum": 0,
"type": "integer"
},
"maxItems": 12,
"type": "array"
},
"currency": {
"description": "Preferred price currency; defaults to GBP.",
"enum": [
"GBP",
"EUR",
"USD"
]
},
"destination_entity_id": {
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"limit": {
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"offset": {
"maximum": 300,
"minimum": 0,
"type": "integer"
},
"rooms": {
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sort": {
"enum": [
"best",
"cheapest",
"highest_rated"
]
}
},
"required": [
"destination_entity_id",
"checkin_date",
"checkout_date"
],
"title": "Skyscanner hotel-search input",
"type": "object"
}