{ "openapi": "3.0.1", "info": { "title": "Tripadvisor Reviews Scraper", "description": "Scrape Tripadvisor reviews with ratings, titles, text, published dates, travel dates, languages, helpful votes, and owner replies. Filter recent feedback by date, rating, language, or known review IDs for scheduled reputation monitoring. Residential proxy is preconfigured for DataDome.", "version": "0.1", "x-build-id": "jJKd3fAC2YKWlHYtA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/schnellscrapers~tripadvisor-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-schnellscrapers-tripadvisor-review-monitor", "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/schnellscrapers~tripadvisor-review-monitor/runs": { "post": { "operationId": "runs-sync-schnellscrapers-tripadvisor-review-monitor", "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/schnellscrapers~tripadvisor-review-monitor/run-sync": { "post": { "operationId": "run-sync-schnellscrapers-tripadvisor-review-monitor", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Place URLs", "type": "array", "description": "Tripadvisor hotel, restaurant, or attraction URLs containing `-Reviews-`. Example: `https://www.tripadvisor.com/Hotel_Review-g60763-d208453-Reviews-Hilton_New_York_Times_Square-New_York_City_New_York.html`.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviewsPerPlace": { "title": "Reviews per place", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum review rows to inspect for each place. Keep this low for scheduled monitoring; 20 reads the newest two review pages.", "default": 20 }, "maxTotalReviews": { "title": "Total review cap", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on review rows written across all place URLs. Free tier: maximum 100 rows per run.", "default": 100 }, "maxPagesPerPlace": { "title": "Pages per place", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum Tripadvisor review pages to open for each place. A page normally contains up to 10 reviews; this is an additional cost guard.", "default": 3 }, "startDate": { "title": "Start date", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only keep reviews published on or after this date in `YYYY-MM-DD` format. Leave empty to use only the page and review caps.", "default": "" }, "endDate": { "title": "End date", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only keep reviews published on or before this date in `YYYY-MM-DD` format. Leave empty for the newest available reviews.", "default": "" }, "reviewRatings": { "title": "Review ratings", "type": "array", "description": "Keep only these star ratings, for example `[1, 2]` for critical feedback. Leave empty for all ratings.", "items": { "type": "string" }, "default": [] }, "language": { "title": "Review language", "pattern": "^$|^[a-zA-Z]{2}$", "type": "string", "description": "Two-letter language code such as `en`, `fr`, or `de`. Leave empty for all languages.", "default": "" }, "knownReviewIds": { "title": "Known review IDs", "type": "array", "description": "Review IDs already stored by your monitoring workflow. Returned rows include `isNew`; enable `newReviewsOnly` to exclude these IDs.", "items": { "type": "string" }, "default": [] }, "newReviewsOnly": { "title": "New reviews only", "type": "boolean", "description": "Write only rows whose IDs are not in `knownReviewIds`. Keep off when you want a fresh snapshot with `isNew` flags.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is recommended for Tripadvisor. The default uses Apify Proxy with the RESIDENTIAL group; DataDome may block direct or datacenter traffic.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Fetch and filter reviews without writing dataset rows. Logs report matched and would-write counts.", "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 } } } } } } } } } }