{ "openapi": "3.0.1", "info": { "title": "Viator Review Scraper", "description": "Scrape public Viator tour reviews by product URL, code, or city search. Filter by stars, traveler type, date, or keyword. Export rating, text, traveler type, and owner reply. No login.", "version": "0.2", "x-build-id": "XZjaButmm9ouTjk5Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~viator-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-viator-review-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/crawloop~viator-review-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-viator-review-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/crawloop~viator-review-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-viator-review-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": "Product URLs", "type": "array", "description": "Public Viator tour or activity URLs. The product code is the last segment, such as d511-3731COLOSSEUM. A destination or search page with no product code is opened as a listing.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "productCodes": { "title": "Product codes", "type": "array", "description": "Viator product codes when you already have them, such as 3731COLOSSEUM. Use this or a product URL.", "items": { "type": "string" } }, "maxReviews": { "title": "Max reviews per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many saved reviews that match the filters, for each product.", "default": 100 }, "sortBy": { "title": "Sort", "enum": [ "ML_SORTED", "DATE", "RATING", "HELPFUL_VOTES" ], "type": "string", "description": "Review order. Most insightful matches the public product page. A published-from date always reads newest first.", "default": "ML_SORTED" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "City or keyword searches, such as Rome Colosseum or Paris. Each query opens a Viator search page and scrapes the first products.", "items": { "type": "string" } }, "maxProductsPerSearch": { "title": "Max products per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many products to open from each search or listing page.", "default": 5 }, "ratings": { "title": "Star ratings", "type": "array", "description": "Keep only these star ratings. Leave empty to keep every rating.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] }, "default": [] }, "travelerTypes": { "title": "Traveler types", "type": "array", "description": "Keep reviews from these travel parties. Leave empty to keep all.", "items": { "type": "string", "enum": [ "COUPLES", "FAMILY", "FRIENDS", "SOLO", "BUSINESS" ], "enumTitles": [ "Couples", "Family", "Friends", "Solo", "Business" ] }, "default": [] }, "reviewSource": { "title": "Review source", "enum": [ "all", "viator", "tripadvisor" ], "type": "string", "description": "Keep Viator reviews, Tripadvisor reviews, or both.", "default": "all" }, "dateFrom": { "title": "Published from", "type": "string", "description": "Keep reviews published on or after this date (UTC), YYYY-MM-DD. Leave empty to keep every date. When set, reviews are read newest first and paging stops at the first older review." }, "reviewKeyword": { "title": "Keyword", "type": "string", "description": "Keep reviews whose title or text contains this word or phrase. Not case sensitive. Leave empty to keep all.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy. US residential is required. Datacenter IPs are blocked.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }