{ "openapi": "3.0.1", "info": { "title": "GetYourGuide Scraper - Tours, Activities, Prices & Reviews", "description": "Scrape GetYourGuide tours & activities by search, destination URL or activity URL. Get title, price + discount, currency, rating, review count, supplier/operator, full location, images and reviews. Supplier intelligence, monitoring, no login, no key, no browser.", "version": "0.1", "x-build-id": "hKLdgqtH56PuSMoWr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~getyourguide-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~getyourguide-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~getyourguide-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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 queries", "type": "array", "description": "Free-text searches run against GetYourGuide — a city, attraction, or theme (e.g. \"rome colosseum\", \"paris\", \"tokyo food tour\"). Each query is crawled across the results pages up to the per-search limit.", "items": { "type": "string" } }, "locationUrls": { "title": "Destination / location URLs", "type": "array", "description": "GetYourGuide destination URLs to crawl their full \"things to do\" listing (e.g. https://www.getyourguide.com/rome-l33/). Paginated automatically. Paste the URL straight from your browser.", "items": { "type": "string" } }, "activityUrls": { "title": "Activity URLs", "type": "array", "description": "Direct GetYourGuide activity / tour page URLs (…-t/). Each is fetched for the full rich record.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (mixed)", "type": "array", "description": "Optional mixed list of GetYourGuide URLs — search pages (/s/?q=…), destination pages (…-l/) or activity pages (…-t/). Each is auto-classified.", "items": { "type": "string" } }, "currency": { "title": "Currency", "type": "string", "description": "3-letter ISO currency for prices (e.g. USD, EUR, GBP, AUD). GetYourGuide quotes prices in this currency; the actual currency returned is always recorded in priceCurrency.", "default": "USD" }, "language": { "title": "Language / locale", "type": "string", "description": "Language code for content (e.g. en, de, es, fr, it). Defaults to English.", "default": "en" }, "includeActivityDetails": { "title": "Include full activity details", "type": "boolean", "description": "Fetch each activity's detail page for the rich record (description, price + discount, rating, review count, supplier, location breakdown, images, embedded reviews). Turn OFF for a fast, cheap listing-only crawl (id, title, URL, thumbnail).", "default": true }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also output the reviews embedded on each activity page (rating, text, author, date) as separate review records. Requires activity details ON.", "default": false }, "maxReviewsPerActivity": { "title": "Max reviews per activity", "minimum": 0, "maximum": 50, "type": "integer", "description": "Cap on review records emitted per activity.", "default": 10 }, "deduplicateSuppliers": { "title": "Supplier / operator intelligence", "type": "boolean", "description": "Also emit one summary record per unique tour operator (\"Activity provider\") seen in the run — how many of their activities appeared, their average rating, total reviews and the cities/countries they operate in. Great for competitor tracking.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only keep activities with at least this average rating (0–5). 0 = no filter.", "default": 0 }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "type": "integer", "description": "Only keep activities with at least this many reviews. 0 = no filter.", "default": 0 }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Only keep activities priced at or above this amount (in the chosen currency). 0 = no filter.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Only keep activities priced at or below this amount (in the chosen currency). 0 = no filter.", "default": 0 }, "freeCancellationOnly": { "title": "Free cancellation only", "type": "boolean", "description": "Only keep activities that offer free cancellation.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Global cap on the number of activities (or listings) scraped across all searches and locations.", "default": 100 }, "maxResultsPerSearch": { "title": "Max results per search / location", "minimum": 1, "type": "integer", "description": "Cap on activities pulled from each individual search query or destination listing.", "default": 60 }, "monitorMode": { "title": "Monitor mode (only new activities)", "type": "boolean", "description": "Remember activity IDs returned in previous runs (in a named key-value store) and emit only NEW ones next time. Pair with an Apify Schedule to watch a destination or search for newly listed tours. The schedule decides WHEN to run; monitor mode decides WHAT is new.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Name of the key-value store that holds the monitor's memory. Use different names to track different searches independently. Lowercase letters, digits and hyphens only.", "default": "getyourguide-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages to fetch in parallel.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify Proxy (default) is recommended. GetYourGuide is served globally with no anti-bot, so the automatic datacenter pool works well.", "default": { "useApifyProxy": true } } } }, "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 } } }, "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 } } } } } } } } } }