Skip to main content

Quick Start Guide

Generating referral links in bulk is a quick and easy process that can help you monetize the traffic you send to Skyscanner. If you are not familiar with the procedure of creating referral links, this is a quick start guide to create referral links in bulk using our Affiliates Link API in a simple and easy way.

There is one main endpoint with the following URL structure:

https://skyscanner.net/g/referrals/v1/{vertical}/{pagetype}?mediaPartnerId={yourmediapartnerID}

So this is the initial structure that you want to modify in order to get your referral link ready.

Step 1: Determine the vertical and page type

Looking at the URL structure above, the first step is fairly simple, you just need to determine the vertical and pagetype you would like your audience to redirect to.

We currently support three verticals, and we have a number of supported page types for each vertical. For more details and information on the verticals and page types we support, please visit our dedicated Verticals and Page Types page.

PAGES TYPES PER VERTICAL
VerticalPagetypes
flightshome, day-view, calendar-month-view, browse-view, multicity, cheap-flights-to, flights-airline
carshome, day-view
hotelshome-view, day-view, hotel-details

Step 2: What params are you using?

Once you've determined the vertical and pagetype, you need to think of the parameter(s) you would like to include and are relevant to the link you are trying to generate.

The parameters depend on the vertical you chose in the previous step, so please refer to the one of the following pages to get an overview of the parameters we support for each vertical: Flights, Cars or Hotels.

As you should already know, we partner with impact.com to track all traffic coming from the links you have generated to Skyscanner, and to pay you a share of commission for the traffic you're sending to our supply partners. Please look at the following table for supported tracking params, or look for more details in our Tracking page.

TRACKING PARAMETERS
ParameterRequiredDescription
mediaPartnerIdREQUIREDYour Impact partner ID as found at Impact.com.
utm_termOPTIONALAdditional alphanumeric tracking parameter you can add to your text links for additional tracking. This will be reported on impact.com as Sub Id 2.

Have you ever used Postman before? No worries if you have not, you just need to download Postman and paste your links so you can test and validate easily. If you want to get more familiar before you try it out with a custom link, you can access our Skyscanner collection (see below) and you can check out some examples for each vertical, by adding your mediaPartnerID and clicking Send.

Check our Postman collection

Run in Postman

info

When testing with Postman, you should expect to receive a 200 response code. That means that you've successfully redirected to the desired page.

image

caution

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.

image

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.

Once you have your referral link(s) ready, you just need to copy and paste on the desired location. The link(s) should be ready to be used, it will redirect to the specified page and the traffic you bring to us will be attributed to your impact.com account.