The Browse Grid Service is similar to the Browse Dates service with months specified but more pre-processing of results is done on the server. Origin and destination must be selected at city or airport level, and dates must be supplied at month level. The days of the selected months will be shown as a grid, with the best quote for each date combination plotted within the grid. Date combinations will only be populated when a quote exists for the pair of dates.
The grid outputs a two-dimensional array with outbound days on one axis and the inbound days on the other axis. This can be easily displayed as a table by an application consuming the service.
The Browse Grid Service provides a grid view of flight and price data for specific outbound and inbound month date ranges. The prices returned contain the cheapest prices for each combination of outbound and inbound date pairs 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:
Examples of questions that can be answered are:
- Find me the cheapest prices from Edinburgh to London for all days in January. This gives the cheapest price for each day in January.
- Find me the cheapest prices from Edinburgh to London departing in January and returning in February. This gives the cheapest prices for combination of all days in January with all days in February.
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||A collection of rows to build a grid view for all possible combinations of outbound and inbound dates. The first row contains outbound dates and first cell of every other row contains an inbound date. All the other cells include the total price of the cheapest journey option for the date pair.|
|Quotes||The cheapest quote with:
|Currencies||Details on how to display the currency specified in the query.|