{ "openapi": "3.0.1", "info": { "title": "Trip.com Attraction Reviews Scraper", "description": "Scrape Trip.com reviews for any attraction. Just add an attraction URL and get every review with its rating, full text, language, photos, author, helpful count and exact post date, plus the Tripadvisor reviews shown alongside. It covers attractions, not hotels. $2.00 per 1,000 reviews.", "version": "1.0", "x-build-id": "gbMhgvqJ8KY5g7o7e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boncross~tripcom-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boncross-tripcom-reviews", "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/boncross~tripcom-reviews/runs": { "post": { "operationId": "runs-sync-boncross-tripcom-reviews", "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/boncross~tripcom-reviews/run-sync": { "post": { "operationId": "run-sync-boncross-tripcom-reviews", "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": { "attractions": { "title": "Attractions", "type": "array", "description": "Trip.com attraction URLs such as https://www.trip.com/travel-guide/attraction/bangkok/the-grand-palace-77012, or bare attraction ids.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (bulk upload)", "type": "array", "description": "Trip.com page addresses, with the option to load them in bulk from a file, a Google Sheet or a remote list. Use this when you have more links than you want to paste. Combined with anything in the list above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviewsPerAttraction": { "title": "Max reviews per attraction", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Stop after this many reviews for each attraction. 0 means every review the attraction has.", "default": 200 }, "maxItems": { "title": "Maximum results for the whole run", "minimum": 0, "type": "integer", "description": "A run-wide ceiling across every target. The per-target limit above applies to each one separately, so ten targets at 50 each returns 500; set this to cap the total. Zero means no run-wide limit. Rows that report an input the actor could not resolve are not counted here and are never charged for.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "relevant", "recent", "rating_desc", "rating_asc" ], "type": "string", "description": "Order the reviews come back in. Most relevant and most recent cover reviews in every language. Trip.com has no rating order of its own, so both rating orders arrange the most relevant reviews that were read (up to 10,000 per attraction) by rating.", "default": "relevant" }, "reviewFilter": { "title": "Review filter", "enum": [ "all", "latest", "photos", "verified", "positive", "negative" ], "type": "string", "description": "Which of Trip.com's own review tabs to read.", "default": "all" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Drop reviews below this rating out of 5. 0 keeps every review. Filtered reviews are free.", "default": 0 }, "withPhotosOnly": { "title": "Only reviews with photos", "type": "boolean", "description": "Keep only reviews that carry at least one photo. Filtered reviews are free.", "default": false }, "reviewedAfter": { "title": "Posted after", "type": "string", "description": "Keep only reviews posted on or after this date, as YYYY-MM-DD. Leave empty for all. With \"Most relevant\" order, setting a date reads the reviews newest first instead, so the run stops as soon as it reaches the date.", "default": "" }, "includeTripadvisor": { "title": "Include Tripadvisor reviews", "type": "boolean", "description": "Also return the Tripadvisor reviews Trip.com shows for the same attraction. Each row is marked with its source.", "default": false }, "maxTripadvisorReviews": { "title": "Max Tripadvisor reviews", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Stop after this many Tripadvisor reviews per attraction. 0 means no limit.", "default": 50 }, "locale": { "title": "Locale", "type": "string", "description": "Locale the reviews and their translations come back in.", "default": "en-XX" }, "language": { "title": "Review language", "enum": [ "", "zh", "en", "ja", "ko", "th" ], "type": "string", "description": "Keep only reviews written in one language. Leave empty for every language.", "default": "" }, "dedupStoreName": { "title": "Only-new store", "type": "string", "description": "Name a key-value store and the actor remembers which reviews it has already returned, so a scheduled run yields only new ones.", "default": "" }, "delayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Pause between calls.", "default": 700 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many requests run at once, each one paced by the delay above. The default is the fastest level measured clean; lower it only if a run reports refusals or errors.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }