skyscanner.place.predict
View connectorPredict Skyscanner flight places from a city or airport query
POST /v1/operations/skyscanner.place.predictHeaders
Authorization: Bearer YOUR_AJAR_API_KEY
x-skyscanner-token: YOUR_SKYSCANNER_TOKEN
Content-Type: application/jsonGuest access needs no Skyscanner account sign-in. The x-skyscanner-token header carries the short-lived guest session from guest bootstrap; it is separate from your ajar Authorization bearer. Keep the same guest token when opening search or offer references.
Inputs
| Parameter | Example type | Example value |
|---|---|---|
| query | string | "Lon" |
| context | object | {"role":"destination","origin_place_ref":"27544008","outbound_date":"2026-10-03","inbound_date":"2026-10-10"} |
Example input
{
"query": "Lon",
"context": {
"role": "destination",
"origin_place_ref": "27544008",
"outbound_date": "2026-10-03",
"inbound_date": "2026-10-10"
}
}Illustrative response for the example input. Availability, prices and result order vary. Replace example references and URLs with values returned by your own requests.
Example response
{
"items": [
{
"place_ref": "27544008",
"place_type": "city",
"name": "London",
"display_name": "London (Any), United Kingdom",
"country": "United Kingdom",
"sky_id": "LOND"
},
{
"place_ref": "95565050",
"place_type": "airport",
"name": "London Heathrow",
"display_name": "London Heathrow (LHR), United Kingdom",
"country": "United Kingdom",
"sky_id": "LHR"
}
]
}Input schema
{
"$id": "https://useajar.com/schemas/skyscanner/place-predict.input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"context": {
"additionalProperties": false,
"properties": {
"destination_place_ref": {
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"inbound_date": {
"format": "date",
"type": "string"
},
"origin_place_ref": {
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"outbound_date": {
"format": "date",
"type": "string"
},
"role": {
"enum": [
"origin",
"destination"
]
}
},
"type": "object"
},
"query": {
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"title": "Skyscanner flight place prediction input",
"type": "object"
}