{ "openapi": "3.0.1", "info": { "title": "Tripadvisor Scraper - Restaurants, Hotels & Attractions", "description": "Extract restaurants, hotels and attractions from any Tripadvisor listing URL. Get rating, review count, ranking, price range, cuisines, phone, full address, opening hours and GPS coordinates. Works on every Tripadvisor country domain.", "version": "0.1", "x-build-id": "PGSk6L4amIQ4KQvCK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/juanoox~tripadvisor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-juanoox-tripadvisor", "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/juanoox~tripadvisor/runs": { "post": { "operationId": "runs-sync-juanoox-tripadvisor", "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/juanoox~tripadvisor/run-sync": { "post": { "operationId": "run-sync-juanoox-tripadvisor", "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": "Tripadvisor listing URLs", "type": "array", "description": "Paste listing pages, e.g. https://www.tripadvisor.com/Restaurants-g187514-Madrid.html. Filter on Tripadvisor first and the Actor copies that exact list. Works on any Tripadvisor domain (.com, .es, .co.uk, .com.ar, .com.mx, .com.br, .fr, .de, .it).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category": { "title": "Place type", "enum": [ "any", "restaurant", "hotel", "attraction" ], "type": "string", "description": "Keep only one type of place. Useful when a listing URL mixes categories.", "default": "any" }, "nameKeywords": { "title": "Name contains", "type": "array", "description": "Keep only places whose name contains any of these words. Case and accent insensitive.", "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "enum": [ "any", "3", "3.5", "4", "4.5", "4.8" ], "type": "string", "description": "Keep only listings rated at or above this threshold. Listings without a rating are excluded. Apify input schemas cannot express decimals as numbers, so the thresholds are offered as choices.", "default": "any" }, "minReviews": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Keep only places with at least this many reviews. Useful to skip newly listed venues." }, "onlyWithPhone": { "title": "Only places with a phone number", "type": "boolean", "description": "Keep only places that publish a phone number. Useful for lead generation.", "default": false }, "maxItems": { "title": "Max results", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Stops the run at this many places. 0 = no limit. This is your direct cost control.", "default": 200 }, "maxPagesPerUrl": { "title": "Max pages per URL", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many listing pages to follow per URL. Tripadvisor returns about 30 places per page.", "default": 10 }, "includeSeen": { "title": "Include places seen before", "type": "boolean", "description": "Turn off for monitoring: each run returns only places that appeared since the previous run.", "default": true }, "proxyTier": { "title": "Starting proxy tier", "enum": [ "none", "datacenter", "residential" ], "type": "string", "description": "Start on datacenter. The Actor escalates to residential automatically if it detects anti-bot challenges, so you do not pay for residential bandwidth unless it is needed.", "default": "datacenter" }, "maxProxyTier": { "title": "Proxy ceiling", "enum": [ "datacenter", "residential" ], "type": "string", "description": "Set to \"Datacenter\" to guarantee the run never consumes residential bandwidth.", "default": "residential" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Parallel requests. Lower it if you see anti-bot challenges.", "default": 5 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Throttles the crawl. Tripadvisor reacts to request rate, so lowering this is often more effective than switching proxies.", "default": 60 }, "maxRequestRetries": { "title": "Retries per request", "minimum": 0, "maximum": 15, "type": "integer", "description": "How many times to retry a blocked request. Each retry gets a different proxy IP, so on Tripadvisor a higher number is what turns a blocked run into a successful one.", "default": 8 } } }, "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 } } } } } } } } } }