GetYourGuide Activity Search API Documentation Search GetYourGuide tours and activities by keyword or place: for each result the id, title, public url, location, duration text, rating, review count, price (text and number), badges and image. 24 results per page, sorted by popularity, price or rating. A search with no matches is still a successful response.
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.
5 optional filters available.
string
Required
Search text, e.g. paris or food tour. Example: paris.
coffee shops
integer
Optional
1-based page number, 24 results per page, 1 to 50. Defaults to 1.
1
string
Optional
One of popularity, price_asc, price_desc, rating_desc. Defaults to popularity.
relevance
integer
Optional
Restrict the search to one GetYourGuide location, e.g. 16 for Paris.
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": {
"page": 1,
"query": "paris",
"results": [
{
"id": 1326356,
"url": "https://www.getyourguide.com/-t1326356/",
"title": "Private Electric Tuk Tuk Tour of Up to 15 Landmarks",
"badges": [
"Top pick"
],
"rating": 5,
"currency": "EUR",
"features": [
"Private group",
"Pickup available"
],
"location": "Paris",
"position": 1,
"image_url": "https://cdn.getyourguide.com/img/tour/e6f459b3301bc65212d8e5103187ab9079c9e08e9292737fd3eb91059a3a3e0c.png/132.jpg",
"price_text": "\u20ac310",
"price_unit": "per group up to 6",
"price_amount": 310,
"review_count": 119,
"duration_text": "2 - 4 hours"
},
{
"id": 1282311,
"url": "https://www.getyourguide.com/-t1282311/",
"title": "Evening Lights Cruise with Legendary Bateaux-Mouches\u00ae",
"badges": [
"Booked 264 times yesterday"
],
"rating": 4.3,
"currency": "EUR",
"location": "Paris",
"position": 2,
"image_url": "https://cdn.getyourguide.com/img/tour/115954509470854c4b5876061d932af25b3db3397d3dcd3b63c6a94855f52a90.jpeg/132.jpg",
"price_text": "\u20ac17",
"price_amount": 17,
"review_count": 6265,
"duration_text": "70 minutes - 1.5 hours",
"original_price_amount": 21
}
],
"has_more": true
},
"meta": {
"billable": true,
"endpoint_family": "activity_search"
},
"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": {
"q": [
"The q field is required."
]
},
"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_search"
},
"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_search"
},
"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_search"
},
"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.