The Browse Quotes Service provides an aggregated view of flight and price data for many origins or many destinations over many time frames, returning the cheapest quotes where available. The prices returned are the cheapest price per day from our cache data.
The following tables show the level of precision supported for the origin and destination places, and the outbound and return dates:
The query types possible are:
Country to Anywhere (which other countries can be reached from the supplied country)
City to Anywhere (which countries can be reached from the supplied city)
Airport to Anywhere (which countries can be reached from the supplied airport)
Country to Country (which destination airports are available from the origin country)
City to Country (which destinations within the country are available from the given city)
Airport to Country (which destinations within the country are available from the given airport)
Country to City (and the reverse)
Country to Airport (and the reverse)
City to City Anytime (which months have prices in the next year)
City to City Month (which days have prices in the specified months)
City to City Day (prices for specified days)
Airport to Airport Anytime (which months have prices in the next year)
Airport to Airport Month (which days have prices in the specified months)
Airport to Airport Day (prices for specified days)
Examples of questions that can be answered are:
Find me the cheapest price for each available route from London to France for the next year. This gives the cheapest known price for each airport in France.
Find me the cheapest price for each available route from London to anywhere departing in January and returning in February. This gives the cheapest known price for each destination country that can be reached from London.
Find me the cheapest prices from Edinburgh to London in the next year. This gives the cheapest known price for each month of the coming year.
Find me the cheapest prices from Edinburgh to London departing in January and returning in February. This gives the cheapest prices for each day in the months on the query.
Find me the cheapest prices from Edinburgh to London departing on 5th January and returning on 6th February. This gives the cheapest prices for these days.
The Browse Quotes Service returns the known quotes for the given search. It is designed to return the raw quotes and does not aggregate the quotes and construct valid return quotes from one way quotes. There will need to be an amount of processing on the client side to get meaningful results. The Browse Routes, Browse Grid and Browse Dates services perform this processing on the server but return just the aggregated cheapest prices and not the full quote details.
The service uses an HTTP GET request.
URL Format (GET)
Parameters (URL / Querystring / Form)
|market||Yes||The user’s market country||String||Skyscanner country code|
|currency||Yes||The user’s selected currency||String||ISO currency code|
|locale||Yes||The user’s selected language||String||ISO locale code|
|originPlace||Yes||The origin place for the search||String||Skyscanner place code|
|destinationPlace||Yes||The destination place for the search||String||Skyscanner place code|
|outboundPartialDate||Yes||The outbound date||String||Valid partial date (yyyy-MM-dd or yyyy-MM)|
|inboundPartialDate||No||The inbound date||String||Valid partial date (yyyy-MM-dd or yyyy-MM)|
|apiKey||Yes||The assigned client api key||String|
For more information on the country, city and airport codes please refer to the Code Schema
HTTP Response Codes
|400||Bad Request – Input validation failed.|
|403||Forbidden – The API Key was not supplied, or it was invalid, or it is not authorized to access the service.|
|429||Too Many Requests – There have been too many requests in the last minute.|
|500||Server Error – An internal server error has occurred which has been logged.|
|Quotes||The cheapest quote with:
|Places||A normalized cross reference lookup of Place information.|
|Carriers||A normalized cross reference lookup of Carrier (operator) information, used by the quotes.|
|Currencies||Details on how to display the currency specified in the query.|
The Browse Quotes service will take all the available levels of place and date precision available from Skyscanner data. It returns the quotes for the next level of drill down, for example for the search London to France it will return quotes for cities in France because London is already at the city level and France is at the country level. This extends to date precision, for example if the search is London to Paris in March 2012 the returned quotes will breakdown to the day level with March 2012.
For a return search quotes can be one of three types:
- Outbound only,
- Inbound only
If a quote has both outbound and inbound leg information it is a return quote. Return quotes can only be used on the pair of dates specified. However, any outbound quote can be combined with any inbound quote to make a return journey.
The reason for this is because there are two different pricing models used by different airlines.