skyscanner.co.in APIskyscanner.co.in ↗
Search flights, compare prices, and retrieve date-range price calendars from Skyscanner. 3 endpoints covering autocomplete, flight search, and price calendars.
curl -X GET 'https://api.parse.bot/scraper/e1554788-7256-4021-ab94-1e1a90a66ee7/autocomplete?query=London&is_destination=false' \ -H 'X-API-Key: $PARSE_API_KEY'
Autocomplete airport/city name search to get GeoIds (entityIds) and IATA codes for use in other endpoints. Returns matching airports and cities based on the query string.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query for airport or city name (e.g. 'London', 'New York', 'Tokyo') |
| is_destination | boolean | Whether the search is for a destination airport/city |
{
"type": "object",
"fields": {
"data": "array of matching airports/cities with place_id, place_name, city_name, country_name, iata_code, entity_id, and resulting_phrase",
"status": "string indicating success"
},
"sample": {
"data": [
{
"place_id": "DEL",
"city_name": "New Delhi",
"entity_id": "95673498",
"iata_code": "DEL",
"place_name": "Delhi Indira Gandhi International",
"country_name": "India",
"resulting_phrase": "Delhi Indira Gandhi International (DEL), New Delhi|Delhi|Delhi NCR|India"
}
],
"status": "success"
}
}About the skyscanner.co.in API
The Skyscanner API gives developers access to 3 endpoints covering flight search, price calendars, and airport/city autocomplete. The search_flights endpoint returns up to 20 itineraries with pricing and booking details for one-way or return trips. The autocomplete endpoint resolves city and airport names into entity IDs and IATA codes required by the other endpoints, and get_price_calendar surfaces the cheapest available fare for each day across a route.
Autocomplete and Entity Resolution
Before running a flight search or price calendar query, you need valid entity IDs and IATA codes. The autocomplete endpoint accepts a query string (e.g. "London", "Tokyo") and returns an array of matching places. Each result includes place_id, place_name, city_name, country_name, iata_code, entity_id, and resulting_phrase. The entity_id and iata_code values feed directly into search_flights and get_price_calendar as origin_id/dest_id and origin_sky_id/dest_sky_id respectively. An optional is_destination boolean lets you bias results toward destination airports.
Flight Search
The search_flights endpoint accepts origin_id, dest_id, and departure_date (YYYY-MM-DD format, must be a future date) as required inputs. Optional parameters include adults, cabin_class (ECONOMY, PREMIUM_ECONOMY, BUSINESS, or FIRST), and return_date for round trips — omitting return_date triggers a one-way search. The response object contains a session_id, a status field indicating whether results are complete or incomplete, a total_results count, and a flights array with each itinerary's itinerary_id and total_price. Results are capped at the top 20 itineraries.
Price Calendar
The get_price_calendar endpoint retrieves daily cheapest fares for a given route. It requires origin_id, dest_id, origin_sky_id, dest_sky_id, year, and month. The response contains a currency field (e.g. INR) and a prices array where each entry has a date, a price, and a group classification of low, medium, or high. Note that the calendar returns prices starting from the current date regardless of the month parameter supplied — past dates within the requested month are not returned.
- Find the cheapest days to fly a specific route by scanning
group: lowentries from the price calendar - Build a flight comparison tool using
total_priceanditinerary_idfromsearch_flights - Autocomplete airport and city inputs in a booking form using
iata_codeandplace_namefrom the autocomplete endpoint - Alert users when fares on a route drop to a
lowgroup classification in the price calendar - Support multi-cabin searches by passing BUSINESS or FIRST to the
cabin_classparameter - Resolve ambiguous city names to canonical entity IDs before triggering a flight search
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Skyscanner have an official developer API?+
What does the price calendar endpoint actually return, and does it cover the full month requested?+
prices array with one entry per available date, each containing a date, a price, and a group value of low, medium, or high. It also returns the currency for the prices (e.g. INR). One known quirk: the endpoint returns data starting from today's date, so if you request a month that has already partially passed, earlier dates in that month will not appear in the response.Does the flight search endpoint return full itinerary details like departure times, airline names, and layover information?+
search_flights response returns itinerary_id and total_price per flight result, along with a session_id, status, and total_results count. Granular details like departure times, airline names, and stopover data are not part of the current response shape. You can fork this API on Parse and revise it to add an endpoint that fetches full itinerary details.Is hotel or car rental search available through this API?+
What happens if the `search_flights` response comes back with status `incomplete`?+
incomplete status means not all airline results had been aggregated at the time of the response. The session_id returned in the response is intended for polling to retrieve a fuller result set once the status transitions to complete.