{
"openapi": "3.0.1",
"info": {
"title": "GetYourGuide Scraper | Tours, Activities, Prices & Reviews",
"description": "GetYourGuide scraper for tours, tickets and activities by keyword, city or link. Get price and discount, rating, reviews, provider, meeting point on a map and next available slot. 30 activities in 8 seconds, 59 fields each. Sort by price or rating, filter by duration and features. No account.",
"version": "1.0",
"x-build-id": "zTg9c8ZzTRnXxYpyV"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~getyourguide-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-getyourguide-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/silentflow~getyourguide-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-getyourguide-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/silentflow~getyourguide-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-getyourguide-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchQueries": {
"title": "🔎 Search keywords",
"type": "array",
"description": "What you would type in the GetYourGuide search bar, one per line: a city (Barcelona), an attraction (rome colosseum) or a theme (tokyo food tour). Each keyword gives up to Max activities rows, in the order GetYourGuide ranks them. A big city lists several hundred activities.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 GetYourGuide links or activity IDs",
"type": "array",
"description": "Paste links copied from getyourguide.com (any language or country domain): a destination or attraction page (https://www.getyourguide.com/rome-l33/), a category page (https://www.getyourguide.com/rome-l33/entry-tickets-tc123/), a search page (/s/?q=paris), a single activity, or just its ID (195566). Destination and search links are read page after page up to Max activities.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "🔢 Max activities per keyword or link",
"minimum": 1,
"type": "integer",
"description": "How many activities each keyword or link gives at most. Each activity is one row with its full page and its latest reviews; the run stops sooner when the listing ends. Set it to what you need: the number of rows drives the cost.",
"default": 30
},
"currency": {
"title": "💱 Currency",
"type": "string",
"description": "Currency of every price (priceFrom, originalPrice). Pick one or type an ISO code (EUR) or a name (euro, Swiss franc). The currency used is written on each row.",
"default": "USD"
},
"language": {
"title": "🗣️ Language",
"type": "string",
"description": "Language of titles, descriptions, highlights, inclusions and policies. Pick one or type a code (de), a locale (pt-PT) or a name (German). Reviews stay in the language their author wrote them in, with a language field.",
"default": "en"
},
"sortBy": {
"title": "↕️ Sort by",
"enum": [
"recommended",
"price_low_to_high",
"price_high_to_low",
"rating"
],
"type": "string",
"description": "Order of the listing, as on the site. Recommended is GetYourGuide's own ranking; each row's rank is its position in the order you pick.",
"default": "recommended"
},
"minRating": {
"title": "⭐ Minimum rating",
"enum": [
"any",
"3.0",
"3.5",
"4.0",
"4.5"
],
"type": "string",
"description": "Keep activities rated at least this much by travelers, with GetYourGuide's own thresholds.",
"default": "any"
},
"maxPrice": {
"title": "💰 Maximum price",
"minimum": 0,
"type": "integer",
"description": "Keep activities whose \"from\" price is at most this amount, in the currency picked above. 0 means no limit.",
"default": 0
},
"duration": {
"title": "⏱️ Duration",
"type": "array",
"description": "Keep activities of these lengths. Leave empty for any length.",
"items": {
"type": "string",
"enum": [
"up_to_3_hours",
"3_to_5_hours",
"5_to_7_hours",
"full_day",
"multi_day"
],
"enumTitles": [
"Up to 3 hours",
"3 to 5 hours",
"5 to 7 hours",
"Full day (7+ hours)",
"Several days"
]
}
},
"features": {
"title": "✅ Features",
"type": "array",
"description": "Keep only activities that offer every feature you pick. Free cancellation is checked on each activity page, so a few more pages are read to fill your rows.",
"items": {
"type": "string",
"enum": [
"free_cancellation",
"private_tour",
"skip_the_line",
"small_group",
"wheelchair_accessible",
"hotel_pickup",
"gyg_originals"
],
"enumTitles": [
"Free cancellation",
"Private tour",
"Skip the line",
"Small group",
"Wheelchair accessible",
"Hotel pickup possible",
"Originals by GetYourGuide"
]
}
},
"maxReviews": {
"title": "💬 Latest reviews per activity",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "How many of the newest reviews each activity row carries, from 0 to 1000. They come inside the activity row, not as extra rows. With 0 the row still has the review count, the average rating and the averages per criterion (guide, value for money...).",
"default": 10
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}