{ "openapi": "3.0.1", "info": { "title": "TripAdvisor Reviews Scraper - All 5 Categories", "description": "Scrape reviews from TripAdvisor for all 5 categories: Hotels, Restaurants, Attractions, Activities, and Cruises. Rich filters for any need: rating, traveler type, language, date range, and more. Fast API-based, no browser needed.", "version": "1.0", "x-build-id": "577StUxQEAk8Lswsm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delicious_zebu~tripadvisor-review-collector/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delicious_zebu-tripadvisor-review-collector", "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/delicious_zebu~tripadvisor-review-collector/runs": { "post": { "operationId": "runs-sync-delicious_zebu-tripadvisor-review-collector", "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/delicious_zebu~tripadvisor-review-collector/run-sync": { "post": { "operationId": "run-sync-delicious_zebu-tripadvisor-review-collector", "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", "required": [ "detailUrls" ], "properties": { "detailUrls": { "title": "Detail Page URLs", "maxItems": 10000, "type": "array", "description": "TripAdvisor detail page URLs. Works with hotels, restaurants, attractions, tours & activities, and cruises.", "items": { "type": "string" } }, "maxReviews": { "title": "Max Reviews Per URL", "minimum": 0, "type": "integer", "description": "Most reviews to collect per URL. 0 means all.", "default": 0 }, "region": { "title": "Country website", "enum": [ "United States", "Canada (English)", "Canada (Français)", "Brasil", "México", "Argentina", "Chile", "Colombia", "Perú", "Venezuela", "United Kingdom", "Italia", "España", "Deutschland", "France", "Sverige", "Nederland", "Türkiye", "Danmark", "Ireland", "Österreich", "Ελλάδα", "Norge", "Portugal", "Россия", "Schweiz", "Suisse", "Svizzera", "Belgique", "België", "日本", "中文国际版", "India", "Australia", "Malaysia", "New Zealand", "Philippines", "Singapore", "Indonesia", "대한민국", "ไทย", "Việt Nam", "台灣", "Hong Kong SAR", "香港特別行政區", "العربية", "مصر", "South Africa", "ישראל" ], "type": "string", "description": "The country site to read from - the selector at the bottom of any TripAdvisor page. It sets the language of TripAdvisor's own labels, not of the reviews.", "default": "United States" }, "currency": { "title": "Currency", "enum": [ "U.S. Dollars", "British Pounds", "Euros", "Canadian Dollars", "Swiss Francs", "Australian Dollars", "New Zealand Dollars", "Japanese Yen", "Chinese Yuan", "Hong Kong Dollars", "Taiwan Dollars", "Korean Won", "Singapore Dollars", "Malaysian Ringgit", "Thai Baht", "Indian Rupees", "Indonesian Rupiah", "Philippine Pesos", "Vietnamese Dong", "Brazilian Reais", "Mexican Pesos", "Argentine Pesos", "Colombian Pesos", "Chilean Pesos", "Peruvian Soles", "South African Rand", "Turkish Lira", "Israeli New Shekel", "Egyptian Pounds", "Russian Rubles", "Swedish Kronor", "Norwegian Kroner", "Danish Kroner", "Polish Zloty", "Saudi Riyal", "UAE Dirham" ], "type": "string", "description": "The currency selector at the bottom of the page. Reviews carry no prices, so it rarely changes the output.", "default": "U.S. Dollars" }, "sortBy": { "title": "Sort by", "enum": [ "Most insightful", "Most recent", "Detailed reviews" ], "type": "string", "description": "The 'Sort by' dropdown above the reviews. 'Most recent' returns every review; 'Most insightful' is TripAdvisor's own ranking and leaves a few out. Date filters force 'Most recent'.", "default": "Most recent" }, "searchQuery": { "title": "Search reviews", "type": "string", "description": "The 'Search reviews' box above the reviews. English keywords only - TripAdvisor's review search does not work in other languages. Leave empty for all reviews.", "default": "" }, "ratingFilter": { "title": "Traveler rating", "type": "array", "description": "The 'Traveler rating' bubbles in the filter panel. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] }, "default": [] }, "travelerType": { "title": "Traveler type", "type": "array", "description": "The 'Traveler type' chips in the filter panel. Leave empty for all.", "items": { "type": "string", "enum": [ "Family", "Couples", "Solo", "Business", "Friends" ] }, "default": [] }, "timeOfYear": { "title": "Time of year", "type": "array", "description": "The 'Time of year' chips in the filter panel, by month of the visit. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ] }, "default": [] }, "reviewLanguage": { "title": "Read reviews in", "enum": [ "", "en", "zhCN", "zhTW", "ja", "ko", "de", "fr", "es", "it", "pt", "ru", "nl", "sv", "tr", "ar", "th", "hu" ], "type": "string", "description": "The 'Read reviews in' dropdown above the reviews. Text comes back in the language you pick; 'originalLanguage' shows what it was written in.", "default": "" }, "startDate": { "title": "Start Date", "type": "string", "description": "Only reviews published on or after this date. Overrides Recent Days, and forces 'Most recent' sorting." }, "recentDays": { "title": "Recent Days", "minimum": 0, "type": "integer", "description": "Only reviews from the last N days. 0 means no limit. Ignored when Start Date is set.", "default": 0 }, "autoTranslate": { "title": "Include translated reviews", "type": "boolean", "description": "The 'Include review content translations' switch in the filter panel. Turn it off to get every review exactly as written instead of translated.", "default": 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 } } } } } } } } } }