Flight Affiliate Search

GET

Flight Affiliate Search

The Flight Affiliate Search API combines Amadeus' flight search technology with Travel Audience's Connect API partners to provide a unique flight search, where all results come with deep-links to book the flight at a partner's website. The API will let you easily provide the traveler with a path to book flights from your application.

Travel Audience Connect partners include

 

Only Travel Audience Connect partner airlines are searched. For an up-to-date list of routes, see the route maps on each partners respective websites above. You can earn commission using the deep links provided in the search results if you sign up for an account at connect.travelaudience.com.

Resource URL

https://api.sandbox.amadeus.com/v1.2 /flights/affiliate-search

Query Parameters


Name Values Description
apikey
(required)

API Key provided for your account, to identify you for API access. Make sure to keep this API key secret.

origin
(required)

City code from which the traveler will depart. See the location and airport interfaces for more information.

destination
(required)

IATA code of the city to which the traveler is going

departure_date
(required)

The date on which the traveler will depart from the origin to go to the destination. The maximum scope for a date range is 2 days, for a larger scope, use the Extensive Search!

return_date

The date on which the traveler will depart from the destination to return to the origin. If this parameter is not specified, the search will find only one-way trips. If this, or the return_by parameter are specified, only return trips are found

adults

The number of adult (age 12 and over) passengers traveling on this flight.

children

The number of child (younger than age 12 on date of departure) passengers traveling on this flight who will each have their own separate seat

infants

The number of infant (younger than age 2 on date of departure) passengers traveling on this flight. Infants travel in the lap of an adult passenger, and thus the number of infants must not exceed the number of adults.

include_merchants

If specified, all results will include at least one flight where one or more of these airlines is the marketing carrier. Airlines are specified using IATA airline codes

exclude_merchants

If specified, no results will include any flights where any of these airlines is the marketing carrier. Airlines are specified using IATA airline codes

max_price

Maximum price of trips to find in the result set, in USD (US dollars) unless some other currency code is specified. By default, no limit is applied

currency

The preferred currency for the results

mobile

Setting this to true will show mobile web deeplinks


Request Body

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Working...

 
The flight affiliate search currently searches on CityJet, Ural Airlines and Avianca Brazil. For the most up-to-date list of destinations served, check the airline's websites. We provide a list of IATA airports codes served by each airline at time of writing on our github space, which we update every few months. However, airline schedules change much more often than that, so for the latest info, always check the airline's website.

Response format

The response is returned as a JSON object with the following pieces of data:

Element Meaning Multiplicity
Root object
errors Errors that may have occurred during the search. 0..1
meta Meta data about the results 1
results The array of search results 0..250
Meta object
carriers A map of meta information for each of the airlines involved in the response 1
Carriers object
2 character airline code The airline carrier code for which this meta information applies 1..n map
CarrierInfo object
name Display name of the airline 1
logos Logos of the airline in a variety of sizes 1
Logos object
small URL to logo of resolution 27x27px 1
medium URL to logo of resolution 60x60px 1
Result object
outbound The flight from the origin to the destination 1
inbound The return flight from the destination to the origin 0..1
fare The price and fare information which applies to all itineraries in this response 1
payout Details of the amount of payout that the affiliate will received per click or if this flight is sold 1
airline The 2 character alphanumeric IATA airline code of the airline that is selling this result 1
deep_link A link to the page from which this result can be purchased from the affiliate 1
Payout object
CPC The Cost per Click commission earned when the provided deep link is clicked 1
CPA The Cost per Action commission earned for a given action from the provided deep link 1
CPS The Cost per Sale commission earned as a result of a booking made from the provided deep link 1
Bound object
flights The ordered array of flight objects that comprise a single bound, to bring the traveler from one point to another 0..4
duration The duration of this bound, including layover time, expressed in the format hh:mm 0..1
Flight object
departs_at Date and time of departure at the origin, in ISO 8601 date format yyyy-MM-ddTHH:mm in the local time at the origin airport 0..5
arrives_at Date and time of arrival at the destination, in ISO 8601 date format yyyy-MM-ddTHH:mm in the local time at the destination airport 0..5
origin Information on the origin airport, from which this flight departs 1
destination Information on the destination airport, at which this flight arrives 1
marketing_airline The 2 character alphanumeric IATA airline code of the airline that is responsible for the traveller this flight 1
operating_airline The 2 character alphanumeric IATA airline code of the airline that is providing the aircraft for this flight. Note that in the USA, if the marketing and operating carrier are different, you are legally required to display this in your application. 1
flight_number The identifier that the airline uses for this flight route. This is most commonly - but not always - a number. When combined with the airline and date, it identifies an individual aircraft's flight 1
aircraft The IATA aircraft type designator of aircraft that will be used for this flight 1
booking_info A booking information object with additional details about how the quality of this flight at the given price. 1
Airport object
airport >The 3 character IATA code of the airport in question for this flight 1
terminal >The terminal identifier at which this flight will arrive or depart in the given airport 0..1
Booking Information object
travel_class The cabin class offered on this flight. An enumeration that will read either ECONOMY, PREMIUM_ECONOMY, BUSINESS or FIRST 1
cabin_code A single character encoding of the travel_class. 1
booking_code The Reservation Booking Designator code that determines the quality and terms of the flight offered for the given price. A single letter from A..Z 1
seats_remaining The minimum number of seats that are still available for this price at the time of search. If the value is a 4 or above, there are often more than this number of seats still available. 1
fare_family Enumeration of the type of fare which this airline is providing, eg. VALUE. This is generally only available for affiliate responses. 1
fare_basis The full Fare Basis Code for the fare being offered. 1
Price object
currency ISO 4217 currency code applicable to this fare 1
total_price The total price for all the requested passengers for this flight as a String 1
price_per_adult The per-passenger fare for each adult on this flight 1
price_per_child The per-passenger fare for each child on this flight 0..1
price_per_infant The per-passenger fare for each infant on this flight 0..1
restrictions The limitations that are associated with this fare 1
fees The fees that apply in addition to the total price of this fare 1
Fare object
total_fare The total price, including taxes per-passenger, for this passenger type, for this itinerary. Always a string, formatted correctly for the given currency 1
tax The tax applied per-passenger, for this passenger type, for this itinerary. Some of this tax may be refundable in the event of cancellation. 1
Restrictions object
refundable Boolean which denotes whether, in the event that the passenger wishes to cancel the flight, any of the monies paid would be returned. 1
change_penalties Boolean which denotes whether a monetary penalty applies, in the event that the passenger wishes to change the dates of any leg of the flight 1
Fees object
service_fees The cost of any required service fees in addition to the total price. 1
creditcard_fees The cost of any fees for common credit cards, such as Visa or Mastercard, in addition to the total price 1
 

Example

For example, to search London to Dublin on January 25th 2016, with results displayed in Euros, you would enter a search request like this:

https://api.sandbox.amadeus.com/v1.2/flights/affiliate-search?origin=LON&destination=DUB&departure_date=2016-01-25&currency=EUR&apikey=<YOUR API KEY HERE>

and receive a response might be like a longer version of this

{
	"meta": {
		"carriers": {
			"WX": {
				"logos": {
					"small": "http://api.connect.travelaudience.com/static/img/airlines/small/WX.png",
					"medium": "http://api.connect.travelaudience.com/static/img/airlines/medium/WX.png"
				},
				"name": "CityJet"
			}
		}
	},
	"results": [
		{
			"fare": {
				"currency": "EUR",
				"price_per_adult": {
					"total_fare": "79.03",
					"tax": "73.03"
				},
				"total_price": "79.03",
				"fees": {
					"service_fees": null,
					"creditcard_fees": null
				},
				"restrictions": {
					"refundable": false,
					"change_penalties": true
				}
			},
			"payout": {
				"CPC": {
					"currency": "EUR",
					"amount": "0.00"
				},
				"CPA": {
					"currency": "EUR",
					"amount": "2.00"
				},
				"CPS": {
					"currency": "EUR",
					"amount": "0.00"
				}
			},
			"outbound": {
				"duration": "01:20",
				"flights": [
					{
						"origin": {
							"airport": "LCY"
						},
						"destination": {
							"terminal": "1",
							"airport": "DUB"
						},
						"aircraft": "AR8",
						"flight_number": "115",
						"arrives_at": "2016-01-25T08:05",
						"operating_airline": "WX",
						"booking_info": {
							"travel_class": "ECONOMY",
							"cabin_code": "M",
							"fare_family": "VALUE",
							"seats_remaining": 9,
							"fare_basis": "V9PR0WGB",
							"booking_code": "V"
						},
						"departs_at": "2016-01-25T06:45",
						"marketing_airline": "WX"
					}
				]
			},
			"travel_class": "ECONOMY",
			"cabin_code": "Y",
			"fare_family": "VALUE",
			"airline": "WX",
			"deep_link": "https://track.connect.travelaudience.com/dlv/verify/?params=.eJwdj0FvgyAARv8LibdRQOoOu9UiyRJdk0Vp9NIwhRZqYVEa1i377yO7vfdO3_cD7ssMXsAlhM81ozuEYoyb0YSHVWEz-hv68P6K6n2PWFciAuV0n8OKMBwvZp4W5RIap6ULKMfkGWIC8wJ5p2CUD5RRHqRb1ZxRJsg5Nm1Faj6ULRdcs7Go7e5bV0J07sv0drj1bR_f9jhvWLWt2_dUunBgpWkMsYPl9sDOcTgK2xxfs7ygDDwBr7VaTmZKJyhOLrX-N5LW_P4Bs2JG0A%3A1a1Lqq%3A-H9irUaAno46srJBe0FYpGj3RtQ"
		}, {
			"fare": {
				"currency": "EUR",
				"price_per_adult": {
					"total_fare": "79.03",
					"tax": "73.03"
				},
				"total_price": "79.03",
				"fees": {
					"service_fees": null,
					"creditcard_fees": null
				},
				"restrictions": {
					"refundable": false,
					"change_penalties": true
				}
			},
			"payout": {
				"CPC": {
					"currency": "EUR",
					"amount": "0.00"
				},
				"CPA": {
					"currency": "EUR",
					"amount": "2.00"
				},
				"CPS": {
					"currency": "EUR",
					"amount": "0.00"
				}
			},
			"outbound": {
				"duration": "01:25",
				"flights": [
					{
						"origin": {
							"airport": "LCY"
						},
						"destination": {
							"terminal": "1",
							"airport": "DUB"
						},
						"aircraft": "AR8",
						"flight_number": "113",
						"arrives_at": "2016-01-25T11:55",
						"operating_airline": "WX",
						"booking_info": {
							"travel_class": "ECONOMY",
							"cabin_code": "M",
							"fare_family": "VALUE",
							"seats_remaining": 9,
							"fare_basis": "V9PR0WGB",
							"booking_code": "V"
						},
						"departs_at": "2016-01-25T10:30",
						"marketing_airline": "WX"
					}
				]
			},
			"travel_class": "ECONOMY",
			"cabin_code": "Y",
			"fare_family": "VALUE",
			"airline": "WX",
			"deep_link": "https://track.connect.travelaudience.com/dlv/verify/?params=.eJwdj0FvgyAARv8LibdRQOYOu9UiSRNdk0Vp9LIwhRZqYVEa1i777yO7vfdO3_cDbssMXsE5hK81o1uEYoyb0YS7VWEz-iv69P6C6l2PWFciAuV0m8OKMBzPZp4W5RIap6ULKMfkBWIC8wJ5p2CUd5RRHqRb1ZxRJsgpNm31qPlQtlxwzcaittuHroTo3Lfp7XDt2z6-7XDesOq5bt9T6cKBlaYxxA6W2wM7xeEobHPcZ3lBGXgCXmu1fJgpnaA4udT630ha8_sH0ndHGQ%3A1a1Lqq%3ARG50cMTaLfWFwBIdLirsuepivIg"
		}, {
			"fare": {
				"currency": "EUR",
				"price_per_adult": {
					"total_fare": "355.86",
					"tax": "135.86"
				},
				"total_price": "355.86",
				"fees": {
					"service_fees": null,
					"creditcard_fees": null
				},
				"restrictions": {
					"refundable": true,
					"change_penalties": false
				}
			},
			"payout": {
				"CPC": {
					"currency": "EUR",
					"amount": "0.00"
				},
				"CPA": {
					"currency": "EUR",
					"amount": "2.00"
				},
				"CPS": {
					"currency": "EUR",
					"amount": "0.00"
				}
			},
			"outbound": {
				"duration": "01:30",
				"flights": [
					{
						"origin": {
							"airport": "LCY"
						},
						"destination": {
							"terminal": "1",
							"airport": "DUB"
						},
						"aircraft": "AR8",
						"flight_number": "119",
						"arrives_at": "2016-01-25T20:00",
						"operating_airline": "WX",
						"booking_info": {
							"travel_class": "ECONOMY",
							"cabin_code": "M",
							"fare_family": "PREMIUM",
							"seats_remaining": 9,
							"fare_basis": "A9FFWGB1",
							"booking_code": "A"
						},
						"departs_at": "2016-01-25T18:30",
						"marketing_airline": "WX"
					}
				]
			},
			"travel_class": "PREMIUM_ECONOMY",
			"cabin_code": "W",
			"fare_family": "PREMIUM",
			"airline": "WX",
			"deep_link": "https://track.connect.travelaudience.com/dlv/verify/?params=.eJwdj9FOgzAYRt-lCXeyvwUxxjtZIZmhLpm0C9yYCpS1Y62BLnUa313i3Tnn6vt-0HWe0BM6ef-5ROkzQAhh02l_M4PfdO4CH86dodo2QHkOJJb9dfIL4Lg76amfB7uitkpaDwkmDzEmcZKBs0Mc5A2itPTSLsMUpVSQMbC6yKoyfztw8iI4eWTfnFRmTFQhBLdfujHtpamb8LrFCaPFfVUf1sL9nuaaaWJaU5o9HUN7FIYdd1GSpRTdIafUML_rfj2S4tWlUv9G1kW_f648R7Y%3A1a1Lqq%3AhhAnhb9OM7BUileZj469uStE35U"
		}
	],
	"request_id": "bb6fa604-6018-4cfe-80b2-cf1c880eec1b"
}