{ "openapi": "3.0.1", "info": { "title": "GetYourGuide, Viator, Klook & Tiqets Tours Scraper", "description": "Compare tour prices and reviews across GetYourGuide, Viator, Klook and Tiqets from one scraper. Pull each tour's price, currency, rating, full reviews, duration and location by destination or URL — built for travel price intelligence, market research and OTA monitoring. JSON or CSV", "version": "0.0", "x-build-id": "EO1po4q6FdX66fQPX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~tours-activities-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-tours-activities-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/memo23~tours-activities-scraper/runs": { "post": { "operationId": "runs-sync-memo23-tours-activities-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/memo23~tours-activities-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-tours-activities-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Listing pages (city / destination / category) or detail pages (a single tour) from GetYourGuide, Viator, Klook or Tiqets. Listing pages fan out to every tour they contain; detail pages are scraped directly. A Klook city page (e.g. klook.com/en-US/destination/c8-bali/1-things-to-do/) returns up to 1,000 activities, most booked first.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "search": { "title": "Search destinations / keywords", "type": "array", "description": "Optional free-text destinations or keywords (e.g. \"Paris\", \"Universal Studios Japan\"). On Klook each term returns up to 1,000 matching activities. On GetYourGuide, Viator and Tiqets it is resolved to their search page, best-effort; explicit Start URLs are more reliable there.", "default": [], "items": { "type": "string" } }, "platforms": { "title": "Platforms to search", "type": "array", "description": "Which platforms the search terms above run on. Leave empty for all four. Start URLs are not affected.", "items": { "type": "string", "enum": [ "getyourguide", "viator", "klook", "tiqets" ], "enumTitles": [ "GetYourGuide", "Viator", "Klook", "Tiqets" ] }, "default": [] }, "maxItems": { "title": "Max tours", "minimum": 1, "type": "integer", "description": "Maximum number of tours/activities to scrape across all start URLs.", "default": 20 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Capture individual review text per tour (author, rating, title, text, date) on all four platforms.", "default": true }, "maxReviewsPerItem": { "title": "Max reviews per tour", "minimum": 0, "type": "integer", "description": "Upper bound on reviews captured per tour when 'Include reviews' is on.", "default": 10 }, "country": { "title": "Exit country (ISO-2)", "type": "string", "description": "Optional ISO-2 country code (e.g. 'us', 'gb', 'de') for the residential exit. All four platforms localize price currency by IP — set this for a consistent currency across results. Klook city and keyword results are always in USD." }, "cacheMaxAgeHours": { "title": "Reuse recent results (hours)", "minimum": 0, "maximum": 720, "type": "integer", "description": "When one of your earlier runs already fetched a tour page, reuse it if it is younger than this many hours instead of fetching it again. Faster and gentler on the source; set 0 to always fetch fresh. Only your own account's pages are reused, and only ones fetched through the same exit country, so a reused page carries the currency you asked for.", "default": 24 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel detail-page fetches. The default suits most runs.", "default": 6 }, "saveDebugFiles": { "title": "Save debug HTML", "type": "boolean", "description": "Save raw HTML of each detail page to the key-value store for debugging.", "default": false } } }, "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 } } } } } } } } } }