The Browse Cache Dates Service can be used to browse possible dates for a journey once the origin and destination have been selected at the city or airport level. The query must specify a year or a particular month during which travel will take place. Different values can be specified for outbound (and inbound for a return query), but they must be of the same precision (whole year or month).
If the year is specified, the service will show months with the best price for each month. If a month is specified, the days of the month will be shown with the best quote for each day.
The Browse Dates Service provides an aggregated view of flight and price data for specific cities or airports over many time frames. The prices returned are the cheapest price per month or 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 are:
- Get the cheapest price from one place to another for each day of a given month
- Get the cheapest price from one place to another for each month within the next year
Examples of questions that can be answered are::
- 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 service uses an HTTP GET request.
The data will be returned in XML format by default. An HTTP Accept header value of ‘application/json’ should be specified to return data in JSON format.
The X-Forwarded-For header must be included with the end user’s IP address. Unless agreed in advance, Skyscanner will be performing robot detection and reserves the right to suspend access to the service without prior notification.
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.|
|Dates||Contains collections of OutboundDates (and InboundDates for return searches) for each date period. Depending on the query type this could be a single day or a whole month. The price is included with the OutboundDates or InboundDates collections. For one-way searches, this is the cheapest one-way price for the given date. For return searches, the price shown is the total return price, which is made up of the cheapest possible combination of legs within the search criteria. For example, for a search outbound in March, and returning in March, the inbound price for March 12th will be the cheapest outbound price for any date in the period March 1st to 12th combined with the cheapest inbound price on March 12th. This avoids the need to combine the quotes in the client code.|
|Quotes||The cheapest quote with:
|Places||A normalized cross reference lookup of Place information.|
|Currencies||Details on how to display the currency specified in the query.|
Return Search Month To Month
Return Search Day To Day