{ "openapi": "3.0.1", "info": { "title": "Viator Scraper: Tours, Activities, Prices, Reviews", "description": "Scrape Viator tours and activities by destination, keyword, or product URL. Returns price from, rating, review count, duration, highlights, category, and bookable status for every listing. Filter by minimum rating, reviews, price range. JSON output.", "version": "0.1", "x-build-id": "lgwWR8fsSramtZWwe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~viator-tours-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-viator-tours-tracker", "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/scrapemint~viator-tours-tracker/runs": { "post": { "operationId": "runs-sync-scrapemint-viator-tours-tracker", "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/scrapemint~viator-tours-tracker/run-sync": { "post": { "operationId": "run-sync-scrapemint-viator-tours-tracker", "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": { "destinationUrls": { "title": "Destination URLs", "type": "array", "description": "Full Viator destination URLs. Example: https://www.viator.com/Paris/d479-ttd, https://www.viator.com/London/d737-ttd. Find the URL for any city by browsing viator.com.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keyword searches like \"cooking class paris\", \"sunset cruise dubai\", \"vatican skip the line\". Uses Viator's own search.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Direct Viator product page URLs to pull. Use when you want exact listings (price history, reviews on a specific tour).", "default": [], "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop tours with a rating below this (out of 5). 4.5 is the sweet spot for top picks.", "default": 0 }, "minReviewCount": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Drop tours with fewer than this many reviews. 50 filters out brand new listings. 500+ only returns best sellers.", "default": 0 }, "maxPriceUsd": { "title": "Maximum price ($)", "minimum": 0, "type": "number", "description": "Drop tours priced above this. Use with minPriceUsd for price brackets.", "default": 0 }, "minPriceUsd": { "title": "Minimum price ($)", "minimum": 0, "type": "number", "description": "Drop tours priced below this. Useful to exclude free city walks when searching premium experiences.", "default": 0 }, "languageCode": { "title": "Language code", "enum": [ "en", "es", "fr", "de", "it", "pt", "ja", "zh" ], "type": "string", "description": "Viator language code. en = English, es = Spanish, fr = French, de = German, it = Italian, pt = Portuguese, ja = Japanese, zh = Chinese.", "default": "en" }, "maxItemsPerSource": { "title": "Max items per source", "minimum": 1, "maximum": 500, "type": "integer", "description": "Per destination or per query cap on rows pushed. Each destination page typically has 30 to 50 featured tours.", "default": 50 }, "maxItemsTotal": { "title": "Maximum items per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on rows pushed to the dataset per run. Controls total cost.", "default": 200 }, "dedupe": { "title": "Deduplicate across runs", "type": "boolean", "description": "Skip product codes pushed on previous runs. Stored in the key value store under SEEN_IDS. Turn off to track price changes over time.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. Residential group recommended if you run every few minutes or hit rate limits.", "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 } } }, "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 } } } } } } } } } }