Overview

The Affiliates Link API is used to provide partner redirects to Skyscanner pages based on provided request parameters.

It can redirect to different pages within Skyscanner based on the provided pagetype parameter. For the full list of page types and examples see the sections below.

info

The Affiliates Link API is a newly developed service that replaced the legacy Referrals API. It is designed to provide the ability to enhance our functionality and feature set. Please note that existing integrations will remain unaffected

API endpoint

The API is accessible at https://skyscanner.net/g/referrals/v1

There is one main endpoint with the following URL structure:

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

The endpoint serves only GET requests and responds with HTTP status 301 redirecting to the desired Skyscanner page.

For the different possible values of the parameters check the tables below. As for the tracking query parameters, please check the following section.

Tracking

We use Impact to track the redirects and associate them with the referral source. You will need to include Impact tracking parameters as query parameters in your requests. Please check the Tracking page for more details on the tracking parameters. Beware that the redirects will not be correctly tracked without configuring these parameters.

Try it out in Postman

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.

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.

REQUEST PARAMETERS

Parameter	Required	Description
vertical	REQUIRED	The vertical you want to redirect to. Allowed values: flights, cars
pagetype	REQUIRED	Page type supported by each vertical. E.g. for flights -> day-view, browse-view... take a look at the next table

PAGE TYPES

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

You can read more about the verticals and page types we support in the dedicated Verticals & Page Types page.