Catalog / Skyscanner public flight discovery

Skyscanner public flight discovery API

skyscanner.co.in

Read-only, live access to Skyscanner's anonymous public flight-location discovery. Use returned `place_id`/`city_id` identifiers and labels to construct a flight search in a consumer application. Flight itinerary and price-calendar retrieval is not published here because the source currently responds with its anti-automation challenge to HTTP retrieval; see x-agent-data.unavailable_endpoints for the evidence-supported limitation.

  • Other
  • flights
  • airports
  • travel
  • location-discovery
1 endpointDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Skyscanner public flight discovery API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Return Skyscanner-ranked airport, city, and location candidates for partial text. Use `place_id`/`city_id` from a returned item in a separate flight-search integration. If `query` is omitted, the adapter sends the source-supported empty query rather than selecting a default place. An unknown query returns an empty `suggestions` array, not a missing-resource error.

Optional parameters 5

Partial place text, including an empty string; omission maps to the source's empty query and Skyscanner accepts up to 256 characters.

Skyscanner market code controlling market-specific results.

Skyscanner locale used for returned labels.

Source search mode: false for origin-style lookup and true for destination-style lookup.

Optional source taxonomy hint; omit it to use the source default.

View call pricing
cURL · Locations suggestions
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/e6b15782-82c3-4500-b45d-fd0c156b070b/v1/locations/suggestions' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETLocations suggestions/v1/locations/suggestions

Return Skyscanner-ranked airport, city, and location candidates for partial text. Use `place_id`/`city_id` from a returned item in a separate flight-search integration. If `query` is omitted, the adapter sends the source-supported empty query rather than selecting a default place. An unknown query returns an empty `suggestions` array, not a missing-resource error.

Input

queryOptionalQuery · string, default:

Partial place text, including an empty string; omission maps to the source's empty query and Skyscanner accepts up to 256 characters.

Example: del

marketOptionalQuery · string, default: IN

Skyscanner market code controlling market-specific results.

Example: IN

localeOptionalQuery · string, default: en-GB

Skyscanner locale used for returned labels.

Example: en-GB

is_destinationOptionalQuery · boolean, default: false

Source search mode: false for origin-style lookup and true for destination-style lookup.

Example: false

limit_taxonomyOptionalQuery · string | null

Optional source taxonomy hint; omit it to use the source default.

Example: City,Airport

Response

querystring
localestring
marketstring
sourcestring
suggestionsobject[]
suggestions[].tags?string[]
suggestions[].geo_id?string | null
suggestions[].city_id?string | null
suggestions[].location?string | null
suggestions[].place_id?string | null
suggestions[].city_name?string | null
suggestions[].iata_code?string | null
suggestions[].region_id?string | null
suggestions[].country_id?string | null
suggestions[].place_name?string | null
suggestions[].city_name_en?string | null
suggestions[].country_name?string | null
suggestions[].highlighting?object[]
suggestions[].highlighting[].0integer
suggestions[].place_name_en?string | null
suggestions[].geo_container_id?string | null
suggestions[].resulting_phrase?string | null
suggestions[].localized_place_name?string | null
suggestions[].untransliterated_resulting_phrase?string | null
is_destinationboolean
limit_taxonomystring | null

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.