GetYourGuide Activity Detail API Documentation Retrieve one GetYourGuide activity: title, description, highlights, additional information (often with the meeting point), category, rating and review count, starting price, duration text, languages, start coordinates, location, images and booking options. Rating and review count are left out for activities without reviews.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
integer
Required
GetYourGuide activity ID, the number after -t in an activity URL. Example: 51059.
1234567890
string
Optional
Three-letter currency code for prices. Defaults to EUR.
USD
string
Optional
Language and region such as en-US. Defaults to en-US.
en
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": 51059,
"url": "https://www.getyourguide.com/-t51059/",
"price": {
"amount": 115,
"currency": "EUR",
"formatted": "\u20ac115"
},
"title": "Paris: 3-Course-Dinner Cruise on the Seine with live music",
"images": [
"https://cdn.getyourguide.com/image/fit=crop,width=800,height=600/tour_img/926695a4d09267059a049d40e86d7bc9d1eb26cf14ba02bedf1b000e68b931c8.jpg",
"https://cdn.getyourguide.com/image/fit=crop,width=800,height=600/tour_img/b88583795b6cd6f05dd6fed781b1e363b64b86ebb636837e5a451857c121090b.jpeg"
],
"rating": 4.6609564,
"options": [
{
"id": 69613,
"title": "Service Etoile \u2013 Private Table aboard a Glass Canopy Boat",
"description": "This option includes a 3-course dinner cruise, an aperitif of Blanc de Blancs Kir and mini cakes with white or red wine. You will be seated at a private table in the center of the glass canopy boat."
}
],
"abstract": "Enjoy an \u00e0 la carte dinner on-board whilst cruising on the River Seine. Discover Paris, the City of Lights, from the water and see the iconic monuments of Paris illuminated.",
"category": "Water activity",
"features": [
"Free cancellation",
"Must book at least 1h in advance",
"Likely to sell out"
],
"location": {
"id": 16,
"name": "Paris",
"type": "city"
},
"languages": [
{
"code": "en",
"type": "live_guide"
},
{
"code": "fr",
"type": "live_guide"
},
{
"code": "de",
"type": "live_guide"
}
],
"highlights": [
"Enjoy an all-inclusive \u00e0-la-carte dinner from menu options",
"Admire panoramic views of Paris floodlit for the night aboard an all glass-boat",
"Begin your adventure by embarking from the iconic Eiffel Tower"
],
"coordinates": {
"latitude": 48.860385,
"longitude": 2.293565
},
"description": "Climb aboard a panoramic sightseeing boat for a dinner cruise along the River Seine in central Paris. Enjoy an \u00e0-la-carte 3-course meal as you take in views of the \"City of Lights\" at night.\n\nDine in a glassed-in boat and admire the historic quays and iconic monuments that pass by. See the golden dome of Les Invalides, the French Parliament, the former Beaux-Arts railway station of the Mus\u00e9e d\u2019Orsay, and the gothic fa\u00e7ade of Notre Dame Cathedral.\nCompliment your cruise with a 3-course meal compl...",
"review_count": 8943,
"duration_text": "2.5 hours",
"completed_bookings": 34692,
"additional_information": "Please note that the dress code for the cruise is smart casual.\nFor safety and security reasons you may be asked to open your bags and suitcases before boarding the boat.\nVegetarian menu options are available on request."
},
"meta": {
"billable": true,
"endpoint_family": "activity_detail"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required query parameter is missing or invalid. This response is not billable.
{
"errors": {
"activity_id": [
"An activity ID is required, e.g. 51059."
]
},
"message": "The request validation failed"
}Resource Not Found
The requested GetYourGuide resource does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "activity_detail"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested GetYourGuide resource was not found."
},
"success": false
}Unexpected Upstream Format
GetYourGuide answered in a format this API does not understand. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "activity_detail"
},
"error": {
"code": "PARSER_DRIFT",
"message": "GetYourGuide answered in an unexpected format. Please retry later."
},
"success": false
}Upstream Unavailable
GetYourGuide blocked or did not answer after several attempts. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "activity_detail"
},
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The GetYourGuide API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.