{
"openapi": "3.0.1",
"info": {
"title": "Ctrip 携程酒店评价 & Trip.com Hotel Reviews Scraper | Global",
"description": "Extract guest reviews from Ctrip 携程 and Trip.com: review text, overall and per-dimension ratings, stay date, room type, traveller type, reviewer country and tier, photos, video and the hotel's own reply. 61 fields per review, plus a per-hotel rating summary. Search by link, name, district or city.",
"version": "0.0",
"x-build-id": "kbzQQRckh6ISlBTZh"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~ctrip-hotel-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-ctrip-hotel-reviews-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/zen-studio~ctrip-hotel-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-ctrip-hotel-reviews-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/zen-studio~ctrip-hotel-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-ctrip-hotel-reviews-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": {
"hotels": {
"title": "酒店 Hotels",
"type": "array",
"description": "填入酒店链接、酒店 ID 或酒店名称，可混合填写。
支持格式：
• 携程链接：https://hotels.ctrip.com/hotels/75329189.html
• Trip.com 链接：https://hk.trip.com/hotels/detail/?hotelId=75329189
• 酒店 ID：75329189
• 酒店名称：上海外滩璞硯酒店
若填的是城市、商圈或地标（例如 外滩、西湖），会自动搜索该区域内的酒店，数量受下方「最多采集酒店数」限制。
Mix links, IDs and names freely. A district or landmark searches that area instead.",
"items": {
"type": "string"
}
},
"city": {
"title": "城市 Destination",
"type": "string",
"description": "搜索整个城市，例如 上海、成都 或 Shanghai。
按好评优先排序，因此先拿到的是该城市口碑最好、评价最多的酒店。
Searches a whole city, best-reviewed first."
},
"maxHotels": {
"title": "最多采集酒店数 Max hotels",
"minimum": 1,
"maximum": 2000,
"type": "integer",
"description": "搜索最多采集多少家酒店，整轮运行合计，不是每个搜索各算一次。
您在上方直接指定的酒店一定会被采集，不占用此额度。
Caps search results across the whole run. Hotels you name yourself are always collected and do not count towards it.",
"default": 10
},
"maxReviews": {
"title": "每家酒店最多评价数 Max reviews per hotel",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "每家酒店最多采集多少条评价。
热门酒店可有上万条评价，取满需要较长时间。
设为较小值可快速预览；评分摘要不受此值影响，始终输出。
Per hotel, not per run. The rating summary is always produced regardless of this number.",
"default": 100
},
"sortBy": {
"title": "排序方式 Sort by",
"enum": [
"recent",
"relevant",
"rating_desc",
"rating_asc"
],
"type": "string",
"description": "评价的排序方式。
最新适合追踪近期口碑变化，评分由低到高适合快速找出差评。
Sort order. 'Lowest rated first' is the fastest way to surface complaints.",
"default": "recent"
},
"reviewLanguages": {
"title": "评价语言 Review languages",
"type": "array",
"description": "只采集用这些语言撰写的评价，可多选。
留空表示不限语言。
注意：并非每家酒店都有每种语言的评价，海外小众语言在中国大陆酒店上可能为零。
Not every hotel has reviews in every language.",
"items": {
"type": "string",
"enum": [
"3",
"2",
"4",
"5",
"9",
"7",
"6",
"8",
"16",
"19",
"17",
"11",
"10",
"13",
"12",
"21",
"18",
"24",
"20"
],
"enumTitles": [
"中文 Chinese",
"英文 English",
"日文 Japanese",
"韩文 Korean",
"俄文 Russian",
"法文 French",
"德文 German",
"西班牙文 Spanish",
"意大利文 Italian",
"葡萄牙文 Portuguese",
"荷兰文 Dutch",
"泰文 Thai",
"越南文 Vietnamese",
"印尼文 Indonesian",
"马来文 Malay",
"阿拉伯文 Arabic",
"波兰文 Polish",
"瑞典文 Swedish",
"土耳其文 Turkish"
]
}
},
"travellerTypes": {
"title": "出行类型 Traveller types",
"type": "array",
"description": "只采集这些出行类型的评价，可多选。
留空表示不限。
Filter reviews by who was travelling.",
"items": {
"type": "string",
"enum": [
"30",
"70",
"10",
"40",
"50",
"60",
"0"
],
"enumTitles": [
"家庭出游 Family",
"情侣 Couple",
"商务出行 Business traveller",
"与好友同行 Traveling with friends",
"独自旅行 Solo traveller",
"为他人预订 Booked for others",
"其他 Other"
]
}
},
"topicTags": {
"title": "主题标签 Topic tags",
"type": "array",
"description": "只采集提到这些主题的评价，例如 前台热情好客、近地铁站、浴缸一流。
标签因酒店而异，每家酒店有自己的一组标签。填写标签名称即可，会自动与该酒店实际拥有的标签匹配；某家酒店没有的标签会被跳过。
每家酒店的完整标签列表（含各自的评价条数）都在评分摘要输出中。
Tags differ per hotel. Give names; they are matched against each hotel's own tags, and the full list ships in the summary output.",
"items": {
"type": "string"
}
},
"keyword": {
"title": "关键词 Keyword",
"type": "string",
"description": "只采集包含该关键词的评价，例如 早餐、停车、隔音。
Only reviews containing this word."
},
"language": {
"title": "输出语言 Output language",
"enum": [
"zh-HK",
"zh-TW",
"en-XX",
"ja-JP",
"ko-KR",
"de-DE",
"fr-FR",
"es-ES",
"it-IT",
"th-TH"
],
"type": "string",
"description": "酒店名称、房型名称、评分标签与主题标签的语言。
不影响评价正文：评价始终以住客撰写时的原文返回。
注意：数据源只提供繁体中文，不提供简体中文。
Does not translate the reviews themselves — those are always returned as written. The source serves Traditional Chinese only.",
"default": "zh-HK"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}