Examples
Overview
This page includes specific referral link examples for the verticals we support and their associated page types. If you're not familiar with or want to learn more about the verticals and page types Skyscanner supports, you can read more on the dedicated Verticals and Page Types page.
If you want to send your users to Skyscanner using a specific market, locale or currency, please check our Localisation page for more details. Otherwise, our detection logic will identify where your users are located and redirect them with the correct localisation settings.
We strongly encourage you to try these examples yourselves and try to change some of the parameters in order to get more familiar with the behaviour changes and the Skyscanner pages. You can access our Skyscanner collection (see below) to try out the example links there.
Check our Postman collection
If you receive a 403 response code when testing with Postman, your request may have been blocked due to security reasons. As an alternative, you can open and validate your link(s) in your web browser instead.
If there's really a need to send requests in Postman, please contact your account manager, or email 
. We'll provide you with an access token, which when added to the request, will prevent it from getting blocked.
The access token must be set as HTTP header x-px-access-token.
Flights
You can check all of the supported paramerers for this vertical on the Flights Parameters page.
Day view
In this example, we are redirecting the traveller to our day-view page with the origin "Paris Charles de Gaulle Airport (CDG)" and the destination "Edinburgh Airport (EDI)". The outbound date is set to be 7th December 2024.
At the end, we also have 2 tracking parameters set, the mediaPartnerId which identifies our partners on impact.com, and the utm_term that is an optional tracking parameter. You can read more about tracking on our Tracking page.
GET https://skyscanner.net/g/referrals/v1/flights/day-view/?origin=cdg&destination=edi&outboundDate=2024-12-07&utm_term=summer&mediaPartnerId=2850210
Browse view
In this example, the user is landing on the browse-view page with the origin being a country "France (FR)" and the destination "Edinburgh Airport (EDI)". The outbound date is set to be 7th December 2024. As a result, the user will get flight options from different cities in the UK to the provided destination EDI.
GET https://skyscanner.net/g/referrals/v1/flights/browse-view/?origin=fr&destination=edi&outboundDate=2024-12-07&mediaPartnerId=2850210
In case a destination is not provided, the user is searching to anywhere, meaning flight options for the provided date(s) to different countries are being displayed.
GET https://skyscanner.net/g/referrals/v1/flights/browse-view/?origin=uk&outboundDate=2024-12-07&mediaPartnerId=2850210
Lastly, if date(s) are not provided, the user will see flight options to different countries and when the preferred country and city are chosen, the user will land on the calendar-month-view page.
GET https://skyscanner.net/g/referrals/v1/flights/browse-view/?origin=uk&mediaPartnerId=2850210
Calendar month view
An example with the same origin and destination as above, but in this case the traveller is redirected to the calendar-month-view page where they can have an overview of the prices for this route for the current month (as the month is not set).
GET https://skyscanner.net/g/referrals/v1/flights/calendar-month-view/?origin=cdg&destination=edi&utm_term=summer&mediaPartnerId=2850210
Multi-City
This is an example of the multicity page where multiple origins and destinations are provided. The traveller will be redirected to the results page where the three routes that are provided will be included.
GET https://skyscanner.net/g/referrals/v1/flights/multicity/?origin0=cdg&date0=2024-10-10&destination0=lond&origin1=lond&date1=2024-10-16&destination1=ams&origin2=ams&date2=2024-10-20&destination2=lis&children=2&childrenv2=2&adultsv2=3&cabinclass=business&mediaPartnerId=2850210¤cy=GBP&locale=en-GB&market=UK
Specific departure times
In this example, the departure-time query parameter configures the first legs departure time to be between 0 (00:00) and 660 minutes (11:00).
GET https://skyscanner.net/g/referrals/v1/flights/day-view?departure-times=0-660&market=UK¤cy=GBP&locale=en-GB&origin=cdg&destination=edi&outboundDate=2024-12-01&inboundDate=2024-12-07
Duration of the flight
In this example we are specifying the duration of the flight to be limited to 22 hours (1320 minutes).
GET https://skyscanner.net/g/referrals/v1/flights/day-view?duration=1320&market=UK¤cy=GBP&locale=en-GB&origin=cdg&destination=edi&outboundDate=2024-12-01&inboundDate=2024-12-07
Preferred alliances
You can also provide a list of preferred alliances. In that case the traveller would be presented with flights that are operated by airlines that are part of the preferred alliance(s).
GET https://skyscanner.net/g/referrals/v1/flights/day-view?alliances=oneworld&market=UK¤cy=GBP&locale=en-GB&origin=cdg&destination=edi&outboundDate=2024-12-01&inboundDate=2024-12-07&mediaPartnerId=2850210
Hotels
You can check all of the supported parameters for this vertical on the Hotels Parameters page.
Day view
This is an example of the day-view page for Hotels and the traveller will be presented with search results for Costa Rica for the provided dates, rooms and number of adults. In order to search for a particular location, the entity_id parameter must be set. For more information on the entity_id supported values, have a look at the IATA codes and Entity IDs page.
GET https://skyscanner.net/g/referrals/v1/hotels/day-view?entity_id=29475422&checkin=2024-03-21&checkout=2024-03-22&adults=6&rooms=2&mediaPartnerId=2850210
Hotel details
In this example, the traveller will be redirected to The Venetian Hotel in Las Vegas, and will be presented with prices for the provided dates, rooms and number of adults.
GET https://skyscanner.net/g/referrals/v1/hotels/hotel-details?hotelId=46948323&checkin=2024-12-01&checkout=2024-12-07&rooms=2&adults=4¤cy=GBP&locale=en-GB&market=UK
Car Hire
You can check all of the supported parameters for this vertical on the Car Hire Parameters page.
Day view
In this example the traveller is being redirected to our day-view page for the provided pick-up and drop-off place "Barcelona (BCN)". The pick-up date and time is set to December 1st at 12:00, and the drop-off to December 7th at 12:00. The driver age is set to 42, and the Impact identification parameter mediaPartnerId is provided as well.
GET https://skyscanner.net/g/referrals/v1/cars/day-view/?pickupPlace=BCN&dropoffPlace=BCN&pickupTime=2024-12-01T12:00&dropoffTime=2024-12-07T12:00&driverAge=42&mediaPartnerId=2850210
A successful response contains no content and returns HTTP 301. The redirect URL is provided in the Location header of the response.
If you wish to look for specific request query parameters per vertical and page type, please refer to the corresponding vertical parameters page. You can easily navigate from here.