Get Top Activities#
Tool
getTopActivities
Description
Get top activities recommendations from Amadeus Discover. It supports location-based filtering with latitude, longitude and radius in km. It also supports configuring the price currency using the currency parameter (e.g. ‘EUR’ for euros). The parameter maxRecommendations can be used to limit the number of returned activities (default is 10 and max is 100). The response is filtered to include only essential fields for clarity. The response’s parameter bookingUrl provides a direct link to book the activity. The response’s parameter travelerUrl provides a link to Amadeus Discover whitelabel page to allow the activity to be booked by a travel agency agent.
Input parameters
Field |
Mandatory |
Type |
Description |
Example |
|---|---|---|---|---|
maxRecommendations |
N |
integer |
Max recommendations is the number of activities returned by the API. Default is 10 |
10 |
latitude |
Y |
number |
The latitude parameter represents the geographic coordinate that specifies the north-south position of a point on the Earth’s surface. It is a required parameter and must be provided as a decimal number. The value should range between -90.0 (south pole) and 90.0 (north pole). Positive values indicate locations in the northern hemisphere, while negative values indicate locations in the southern hemisphere. |
43.53573 |
longitude |
Y |
number |
The longitude parameter represents the geographic coordinate that specifies the east-west position of a point on the Earth’s surface. It is a required parameter and must be provided as a decimal number. The value should range between -180.0 (west of the prime meridian) and 180.0 (east of the prime meridian). Positive values indicate locations in the eastern hemisphere, while negative values indicate locations in the western hemisphere. |
-5.66152 |
radius |
N |
integer |
The radius parameter defines the search radius around the specified geographic coordinates (latitude and longitude) within which activities will be considered. It is an optional parameter and must be provided as a positive decimal number. The value represents the distance in kilometers. If not specified, the default behavior is to include all activities without a radius constraint. Default value is 100 meaning 100kms |
50 |
currency |
N |
integer |
The currencyCode parameter specifies the currency in which prices should be displayed. It is an optional parameter and must be provided as a three-letter ISO 4217 currency code (e.g., USD for US Dollar, EUR for Euro). If not specified, the default EUR currency used by the API will be applied. |
USD |
Output sample
Response Body
[
{
"id": 138979743,
"productId": 138979743,
"externalId": "2eb6743e-c7ad-481e-af9f-761f6ed53088",
"title": "Magical and Exclusive Private Visit to the Fonte Baxa Garden, Luarca",
"creationDate": "2023-09-10T01:22:51.178+00:00",
"updateDate": "2025-09-29T10:55:45.130+00:00",
"instantConfirmation": true,
"instantDelivery": true,
"availabilityType": "OPENING_HOURS",
"redemptionMethod": "DIGITAL",
"description": "<div><p>Get to know this orchard of more than 15 hectares located on the edge of the Cantabrian Sea by the family that created the Fonte Baxa Garden. A unique experience in which you will also get to know the private part of this garden.</p></div>",
"thumbnailImage": "ceb1f29f-e2ab-496a-b47c-c618f5e1d4fc",
"bookingEngine": "HOLIBOB_VIATOR",
"bookingEngineName": "Holibob",
"bookingUrl": "https://api-uat.amadeus-discover.com/to/28Tpy1LyN0hFGD6qA?currency=USD",
"minPrice": 16,
"maxPrice": 16,
"priceCurrency": "USD",
"pricingUnit": "NONE",
"address": "Luarca, Spain",
"geoLocation": {
"latitude": 43.5445968,
"longitude": -6.5423906,
"geoHash": "ezerep5cxj"
},
"duration": "2 hours",
"durationHours": 2,
"galleryImages": [
{
"url": "https://images.holibob.tech/eyJrZXkiOiJwcm9kdWN0SW1hZ2VzL2ViNWRjYTI3LWNmOTYtNDE3Yy04MWJlLTZjOTgwMzUyMzJiYSIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb3ZlciIsIndpZHRoIjoxOTIwLCJoZWlnaHQiOjEwODB9fX0=",
"order": 5
},
{
"url": "https://images.holibob.tech/eyJrZXkiOiJwcm9kdWN0SW1hZ2VzL2Y3NDc2OTdhLTBjYWUtNDVhZi1hODNiLTY0M2ZjOGY2NjEyNyIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb3ZlciIsIndpZHRoIjoxOTIwLCJoZWlnaHQiOjEwODB9fX0=",
"order": 3
},
{
"url": "https://images.holibob.tech/eyJrZXkiOiJwcm9kdWN0SW1hZ2VzL2IwOTZhOGFiLWYwMzUtNDc1MS1hYjE1LTFhOTdiYTg1YmM0ZCIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb3ZlciIsIndpZHRoIjoxOTIwLCJoZWlnaHQiOjEwODB9fX0=",
"order": 1
},
{
"url": "https://images.holibob.tech/eyJrZXkiOiJwcm9kdWN0SW1hZ2VzLzUxNmY1MmQ1LTI0Y2EtNGM3Mi1iYmRhLTZmMzIyODE2MDFhNSIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb3ZlciIsIndpZHRoIjoxOTIwLCJoZWlnaHQiOjEwODB9fX0=",
"order": 0
},
{
"url": "https://images.holibob.tech/eyJrZXkiOiJwcm9kdWN0SW1hZ2VzL2NiMmUxMDQ2LWQyODctNDg4Zi04MTMzLTM0YzY2Y2Q5MjBjOSIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb3ZlciIsIndpZHRoIjoxOTIwLCJoZWlnaHQiOjEwODB9fX0=",
"order": 4
},
{
"url": "https://images.holibob.tech/eyJrZXkiOiJwcm9kdWN0SW1hZ2VzLzUyYjY0MTZiLTI1NGQtNDgxNy05MzFhLTE1NWQ1ZGEzYzFlMyIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb3ZlciIsIndpZHRoIjoxOTIwLCJoZWlnaHQiOjEwODB9fX0=",
"order": 6
},
{
"url": "https://images.holibob.tech/eyJrZXkiOiJwcm9kdWN0SW1hZ2VzLzAwMDVmM2E0LTFlYWEtNDYyZi04ODhiLWU5MDkyYTg4ZWMzMyIsImVkaXRzIjp7InJlc2l6ZSI6eyJmaXQiOiJjb3ZlciIsIndpZHRoIjoxOTIwLCJoZWlnaHQiOjEwODB9fX0=",
"order": 2
}
],
"categories": [
{
"level": 1,
"code": "tours"
}
],
"supplier": {
"id": 138842681,
"name": "Fonte Baxa",
"externalId": "682e55e4-7784-4042-844a-3aea84ed6d08",
"creationDate": "2023-09-09T03:20:57.664+00:00",
"updateDate": "2025-10-02T10:37:44.129+00:00",
"contact": {},
"countryCode": "ES",
"countryName": "Spain"
},
"onlineBookable": true,
"descriptors": [],
"availableLanguages": [
"fr",
"de",
"pt",
"en",
"it",
"pl",
"es",
"zh"
],
"cityName": "Asturias",
"rating": 4.214,
"numberOfRatings": 14,
"countryName": "Spain",
"taxonomies": [
[
{
"uuid": "41a2aefb-2282-40ac-8b33-cdea80a9e358",
"name": "No Category",
"level": 1,
"slug": "activities-no-category",
"family": "activities",
"nameFullPath": "No Category",
"parentUuid": "41a2aefb-2282-40ac-8b33-cdea80a9e358",
"version": 1,
"isCurrent": true,
"startDate": "2022-03-22T19:17:56.534158Z",
"nameTranslation": "",
"value": 1
}
],
[
{
"uuid": "5af57c27-2831-4605-81c9-f023c759b98c",
"name": "Leisure",
"level": 1,
"slug": "trip-context-leisure",
"family": "trip-context",
"parentUuid": "5af57c27-2831-4605-81c9-f023c759b98c",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Leisure",
"value": 0.85
}
],
[
{
"uuid": "c001fca2-725e-481d-a3c8-cff8aa02001f",
"name": "Couple",
"level": 1,
"slug": "traveler-type-couple",
"family": "traveler-type",
"parentUuid": "c001fca2-725e-481d-a3c8-cff8aa02001f",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Couple",
"value": 0.8
}
],
[
{
"uuid": "55c3506f-9474-4f77-a5c1-a1492cf9c26c",
"name": "Staycation",
"level": 1,
"slug": "trip-context-staycation",
"family": "trip-context",
"parentUuid": "55c3506f-9474-4f77-a5c1-a1492cf9c26c",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Staycation",
"value": 0.7
}
],
[
{
"uuid": "913eec3e-7dd0-471a-a002-88d516908d4b",
"name": "Summer",
"level": 1,
"slug": "season-summer",
"family": "season",
"parentUuid": "913eec3e-7dd0-471a-a002-88d516908d4b",
"version": 2,
"isCurrent": true,
"startDate": "2024-06-11T13:30:37.875338Z",
"nameTranslation": "Summer",
"value": 0.6
}
],
[
{
"uuid": "bf62797f-471e-48f8-a56e-c0ad16f814b0",
"name": "All-year",
"level": 1,
"slug": "season-all-year",
"family": "season",
"parentUuid": "bf62797f-471e-48f8-a56e-c0ad16f814b0",
"version": 2,
"isCurrent": true,
"startDate": "2024-06-11T13:30:37.875338Z",
"nameTranslation": "All-year",
"value": 0.3
}
],
[
{
"uuid": "f4f3502d-bc6d-4608-a431-42510293a47a",
"name": "Business",
"level": 1,
"slug": "trip-context-business",
"family": "trip-context",
"parentUuid": "f4f3502d-bc6d-4608-a431-42510293a47a",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Business",
"value": 0.3
}
],
[
{
"uuid": "865abf18-7b21-4ad3-82c2-9fdd8d4c2d4d",
"name": "Family",
"level": 1,
"slug": "traveler-type-family",
"family": "traveler-type",
"parentUuid": "865abf18-7b21-4ad3-82c2-9fdd8d4c2d4d",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Family",
"value": 0.25
}
],
[
{
"uuid": "ac109ef4-67c3-498b-abcb-cb69fa2940a4",
"name": "Solo",
"level": 1,
"slug": "traveler-type-solo",
"family": "traveler-type",
"parentUuid": "ac109ef4-67c3-498b-abcb-cb69fa2940a4",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Solo",
"value": 0.2
}
],
[
{
"uuid": "e7d6c05a-6003-496a-a68b-d3c974be0d70",
"name": "Winter",
"level": 1,
"slug": "season-winter",
"family": "season",
"parentUuid": "e7d6c05a-6003-496a-a68b-d3c974be0d70",
"version": 2,
"isCurrent": true,
"startDate": "2024-06-11T13:30:37.875338Z",
"nameTranslation": "Winter",
"value": 0.1
}
],
[
{
"uuid": "8d9be0ee-8ebb-42d0-a60c-0fe86f5bff87",
"name": "Group",
"level": 1,
"slug": "traveler-type-group",
"family": "traveler-type",
"parentUuid": "8d9be0ee-8ebb-42d0-a60c-0fe86f5bff87",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Group",
"value": 0.1
}
],
[
{
"uuid": "54b2df64-3cb9-4df5-be3a-34533722cbbe",
"name": "Severity",
"level": 1,
"slug": "risk-severity",
"family": "risk",
"parentUuid": "54b2df64-3cb9-4df5-be3a-34533722cbbe",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Severity",
"value": 0.05
}
],
[
{
"uuid": "031b9f86-0fc2-4684-9651-e431ea6bbea9",
"name": "Likelihood",
"level": 1,
"slug": "risk-likelihood",
"family": "risk",
"parentUuid": "031b9f86-0fc2-4684-9651-e431ea6bbea9",
"version": 2,
"isCurrent": true,
"startDate": "2024-02-13T15:39:57.904070Z",
"nameTranslation": "Likelihood",
"value": 0.02
}
]
],
"availabilityPeriods": {},
"isCancellable": true,
"cancellationCutOffAmount": 24,
"cancellationCutOffUnit": "hours",
"cancellationCutOff": "A full refund will apply if you cancel more than 24 hours before the activity start time./nNo refund is possible if you cancel less than 24 hours before the activity start time.",
"modalitiesIncluded": "Entrance to the Garden",
"modalitiesAdditionalInfo": "Service animals allowed/nSuitable for all physical fitness levels",
"handiAccess": false,
"relevanceScore": 20.8745,
"displayedLanguage": "en",
"continentCode": "EU",
"guideLanguages": {
"live": [
"en",
"ES"
]
}
}
]