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
Vertical | Pagetypes |
---|---|
flights | home, day-view, calendar-month-view, browse-view, multicity, cheap-flights-to, flights-airline |
cars | home, day-view |
hotels | home-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.
Step 3: Add tracking to your link
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
Parameter | Required | Description |
---|---|---|
mediaPartnerId | REQUIRED | Your Impact partner ID as found at Impact.com. |
utm_term | OPTIONAL | Additional alphanumeric tracking parameter you can add to your text links for additional tracking. This will be reported on impact.com as Sub Id 2. |
Step 4: Validate the link(s) using Postman
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
When testing with Postman, you should expect to receive a 200
response code. That means that you've successfully redirected to the desired page.
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
.
Step 5: Start using the referral link
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.