{ "openapi": "3.0.1", "info": { "title": "Tripadvisor Scraper - Hotels, Restaurants & Reviews", "description": "Scrape Tripadvisor hotels, restaurants, and attractions with full reviews. Extract names, ratings, review text and dates, reviewer profiles, prices, amenities, addresses, and photos. Great for market research and reputation monitoring. Export to JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "GueGDc7jyF9rWasGC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nourishing_courier~tripadvisor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nourishing_courier-tripadvisor-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/nourishing_courier~tripadvisor-scraper/runs": { "post": { "operationId": "runs-sync-nourishing_courier-tripadvisor-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/nourishing_courier~tripadvisor-scraper/run-sync": { "post": { "operationId": "run-sync-nourishing_courier-tripadvisor-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": { "query": { "title": "Search Query", "type": "string", "description": "Location name to search on Tripadvisor (e.g. 'New York', 'Paris', 'Tokyo'). The scraper takes the first location result and scrapes hotels, restaurants, and attractions." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Tripadvisor URLs. Supports hotel, restaurant, attraction detail pages (Hotel_Review, Restaurant_Review, Attraction_Review) and category/search URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum Results", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Maximum total results to extract. Use 0 for unlimited.", "default": 100 }, "includeHotels": { "title": "Include Hotels", "type": "boolean", "description": "Include hotels when scraping a location", "default": true }, "includeRestaurants": { "title": "Include Restaurants", "type": "boolean", "description": "Include restaurants when scraping a location", "default": true }, "includeAttractions": { "title": "Include Attractions", "type": "boolean", "description": "Include attractions/things to do when scraping a location", "default": true }, "includeVacationRentals": { "title": "Include Vacation Rentals", "type": "boolean", "description": "Include vacation rental listings when scraping a location", "default": false }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Include review data for each place", "default": false }, "maxReviews": { "title": "Max Reviews Per Place", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum reviews to scrape per place. Use 0 for unlimited.", "default": 0 }, "lastReviewDate": { "title": "Reviews Since Date (YYYY-MM-DD)", "type": "string", "description": "Only include reviews posted after this date", "default": "" }, "checkInDate": { "title": "Hotel Check-in Date (YYYY-MM-DD)", "type": "string", "description": "Check-in date for hotel price calculations", "default": "" }, "checkOutDate": { "title": "Hotel Check-out Date (YYYY-MM-DD)", "type": "string", "description": "Check-out date for hotel price calculations", "default": "" }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "ja", "ko", "zh", "ru", "ar", "sv", "da", "no", "fi", "pl", "cs", "hu", "ro", "tr", "th", "vi", "id", "el", "he", "hi", "uk", "bg", "hr", "sk", "sl", "lt", "lv", "et", "sr", "ca", "ms" ], "type": "string", "description": "Language for results", "default": "en" }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "JPY", "CNY", "INR", "BRL", "MXN", "SEK", "NOK", "DKK", "CHF", "KRW", "SGD", "HKD", "TWD", "THB", "MYR", "IDR", "PHP", "VND", "NZD", "ZAR", "AED", "SAR", "TRY", "PLN", "CZK", "HUF", "RON", "BGN", "HRK", "RUB", "ILS", "EGP", "ARS", "CLP", "COP", "PEN" ], "type": "string", "description": "Currency for price data", "default": "USD" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for scraping", "default": { "useApifyProxy": true } }, "maxRetries": { "title": "Max Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum retries for failed requests", "default": 3 } } }, "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 } } } } } } } } } }