{ "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": "bwyFA94FHr6GyypUH" }, "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": "List of TripAdvisor detail page URLs to scrape reviews from. Supports all 5 categories: Hotel_Review, Restaurant_Review, Attraction_Review, AttractionProductReview (Activity), Cruise_Review.", "items": { "type": "string" } }, "maxReviews": { "title": "Max Reviews Per URL", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per detail page URL. Set 0 for unlimited (scrape all).", "default": 0 }, "region": { "title": "Region", "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": "Region/language setting (corresponds to the country/region selector at the bottom of TripAdvisor website).", "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": "Currency setting (corresponds to the currency selector at the bottom of TripAdvisor website).", "default": "U.S. Dollars" }, "ratingFilter": { "title": "Rating Filter", "type": "array", "description": "Filter by rating. Select one or more values from 1-5. Leave empty for all ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] }, "default": [] }, "travelerType": { "title": "Traveler Type", "type": "array", "description": "Filter by traveler type. Leave empty for all types.", "items": { "type": "string", "enum": [ "Family", "Couples", "Solo", "Business", "Friends" ] }, "default": [] }, "timeOfYear": { "title": "Time of Year (Months)", "type": "array", "description": "Filter by month (1-12). For example, [3, 4, 5] means March to May. Leave empty for all months.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ] }, "default": [] }, "reviewLanguages": { "title": "Review Languages", "type": "array", "description": "Filter by review language. For example, ['en'] for English only, ['en', 'zhCN'] for English and Chinese. Leave empty for all languages. Available: en, zhCN, zhTW, ja, ko, de, fr, es, it, pt, ru, nl, sv, tr, ar, th, hu", "items": { "type": "string", "enum": [ "en", "zhCN", "zhTW", "ja", "ko", "de", "fr", "es", "it", "pt", "ru", "nl", "sv", "tr", "ar", "th", "hu" ] }, "default": [] }, "startDate": { "title": "Start Date", "type": "string", "description": "Only scrape reviews published on or after this date. Leave empty to scrape all reviews. Takes priority over Recent Days if both are set." }, "recentDays": { "title": "Recent Days", "minimum": 0, "type": "integer", "description": "Only scrape reviews from the last N days. For example, 30 means last 30 days. Set 0 for no limit. Ignored if Start Date is set.", "default": 0 }, "sortBy": { "title": "Sort By", "enum": [ "newest", "detailed" ], "type": "string", "description": "Review sorting method. 'newest' = most recent first (default), 'detailed' = most detailed reviews first.", "default": "newest" }, "autoTranslate": { "title": "Auto Translate to English", "type": "boolean", "description": "If true, non-English reviews will be auto-translated to English. If false, reviews are returned in their original language. Note: Translation may not work when Review Languages filter is set to a specific non-English language.", "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 } } }, "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 } } } } } } } } } }