{ "openapi": "3.0.1", "info": { "title": "Qunar Hotel Reviews Scraper - 去哪儿 Ratings & Reviews", "description": "Scrape Qunar (去哪儿) hotel reviews - guest ratings, review text, per-review sub-ratings, travel type, photos, owner replies and reviewer data, with LLM-ready markdown.", "version": "1.0", "x-build-id": "7MwFj2EDRSHFsJl52" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/factden~qunar-hotel-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-factden-qunar-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/factden~qunar-hotel-reviews-scraper/runs": { "post": { "operationId": "runs-sync-factden-qunar-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/factden~qunar-hotel-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-factden-qunar-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": { "startUrls": { "title": "🏨 Qunar hotel URLs", "minItems": 0, "maxItems": 100, "type": "array", "description": "Paste one or more Qunar (去哪儿) hotel page URLs. Copy them straight from your browser, for example `https://hotel.qunar.com/cn/nanjing/dt-17/` or `https://touch.qunar.com/hotelcn/nanjing/dt-17`. Each URL is resolved to its internal `{city}_{id}` key automatically. Add at least 1 hotel; up to 100 hotels per run across this field and Hotel IDs combined.", "items": { "type": "string" } }, "hotelIds": { "title": "🆔 Hotel IDs (optional shortcut)", "minItems": 0, "maxItems": 100, "type": "array", "description": "Already know the hotel's ID? Add it here in `{city}_{id}` form, e.g. `nanjing_17`. This is handy for API and AI-agent callers that hold the ID directly. A bare number like `17` is rejected because it has no city prefix — always include the city. Counts toward the same 100-hotel-per-run cap as the URLs above.", "items": { "type": "string" } }, "maxReviews": { "title": "🔢 Max reviews per hotel", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many reviews to collect for each hotel, newest first. Qunar exposes at most 10,000 reviews per hotel. Lower this to keep runs fast and cheap; raise it for a full history pull.", "default": 200 }, "fromDate": { "title": "📅 Only reviews since (date cutoff)", "type": "string", "description": "Keep only reviews submitted on or after this date (YYYY-MM-DD). Because reviews are read newest-first, the scraper stops the moment it reaches an older review instead of scanning the whole history — perfect for a daily or weekly sync that only fetches what's new. Leave blank to collect the most recent reviews up to your limit." }, "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "Route requests through Apify Proxy. The datacenter default works well for Qunar (its review origin has no CDN), so most users can leave this untouched. Switch to residential only if you see blocks.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }