{ "openapi": "3.0.1", "info": { "title": "Viator Scraper — Tours, Prices, Ratings & Reviews", "description": "Scrape Viator tours and activities from destination, category and search pages: prices, ratings, reviews, duration, cancellation policy, images, plus optional details and reviews.", "version": "0.1", "x-build-id": "vtVfWcnxKESz4bhL5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~viator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-viator-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/tortuga~viator-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-viator-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/tortuga~viator-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-viator-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": "Viator pages to scrape: destination pages (https://www.viator.com/Paris/d479-ttd), category pages (https://www.viator.com/Paris-tours/Walking-Tours/d479-g16-c56), attraction pages (https://www.viator.com/Paris-attractions/Eiffel-Tower/d479-a89) or search results (https://www.viator.com/searchResults/all?text=rome+food+tour). A single tour URL (…/tours/Paris/…/d479-67584P2) returns that tour with full details. Listing pages are paginated automatically. Required unless you fill in Search terms.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Free-text searches, run like the Viator search box (e.g. \"rome food tour\", \"grand canyon helicopter\"). Viator returns at most 200 tours per search.", "items": { "type": "string" } }, "maxItems": { "title": "Max tours", "minimum": 1, "type": "integer", "description": "Stop after this many tours in total (across all start URLs and searches). Reviews do not count towards this limit; they are capped per tour by 'Max reviews per tour'. Listing pages hold 24 tours each.", "default": 100 }, "currency": { "title": "Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "3-letter ISO code (USD, EUR, GBP, AUD, CAD, …) to show prices in. Leave empty for the site default (usually USD)." }, "includeDetails": { "title": "Include tour details", "type": "boolean", "description": "Also open every tour page to get highlights, inclusions/exclusions, the full cancellation policy, itinerary stops with coordinates, meeting point, languages, supplier, group size, next available date and the rating distribution. Slower and charged extra per tour (see pricing).", "default": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also save the newest reviews of every tour as separate dataset items (type \"review\"): rating, title, text, the reviewer's nickname as Viator shows it, date, helpful votes and the operator's response. Charged per review (see pricing).", "default": false }, "maxReviewsPerTour": { "title": "Max reviews per tour", "minimum": 1, "type": "integer", "description": "Upper limit of reviews saved per tour when 'Include reviews' is on (newest first, 10 per request).", "default": 20 }, "reviewsNewerThan": { "title": "Only reviews newer than", "type": "string", "description": "Only reviews newer than: a date (YYYY-MM-DD) or a period such as '7 days' or '24 hours'. Turns on reviews. Reviews are read newest first and paging stops at the first page that is entirely older." }, "onlyNewOrChanged": { "title": "Only new or changed items", "type": "boolean", "description": "Remember what earlier runs of this search returned and output only new items or items whose price/status changed. Use with a Schedule; unchanged items are not charged. With this on, Max tours is the number of tours checked each run (the watched window), so a run never digs deeper than the first one. Compared: from-price, struck-through price, rating and free cancellation. With reviews on, only reviews not seen before are saved, also for tours that did not change. Prices are converted into the chosen currency, so pick the destination's own currency (EUR for Paris, GBP for London): converted prices move with exchange rates every day. With Currency empty, monitoring asks for USD. Viator orders tours by the visitor's country, so monitoring pins the proxy to the US unless you set a proxy country.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Viator uses DataDome bot protection, which now blocks the default datacenter proxy with a 403 challenge, so this Actor defaults to the RESIDENTIAL proxy group. If that also gets challenged, try the UNBLOCKER group (billed per successful request).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }