{ "openapi": "3.0.1", "info": { "title": "Fliggy Hotel Reviews Scraper - 飞猪 Hotels", "description": "Scrape Fliggy (飞猪) hotel reviews - guest ratings, review text, check-in date, room type, reviewer location, sentiment tags and hotel profiles, with LLM-ready markdown. Search by city name or paste hotel URLs. Structured JSON/CSV for analytics, AI and market research. No login.", "version": "1.0", "x-build-id": "epBxfqCjncvvKcmlv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/factden~fliggy-hotel-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-factden-fliggy-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~fliggy-hotel-reviews-scraper/runs": { "post": { "operationId": "runs-sync-factden-fliggy-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~fliggy-hotel-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-factden-fliggy-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": { "mode": { "title": "🧭 Mode", "enum": [ "reviews", "discovery" ], "type": "string", "description": "What to do. \"Reviews\" scrapes the hotels/items you paste below. \"Discovery\" finds every hotel in a city and scrapes each one.", "default": "reviews" }, "startUrls": { "title": "🔗 Hotel URL or ID", "maxItems": 100, "type": "array", "description": "Reviews mode. Fliggy hotel/item URLs, or just the bare hotel ID (shid). Accepts every Fliggy URL form: www.fliggy.com/jiudian/detail/{city}/{shid}, hotel.fliggy.com/hotel_detail2.htm?shid=..., mobile/H5 links, and travel-item URLs (id=...).", "items": { "type": "string" } }, "searchCities": { "title": "🏙️ City name", "maxItems": 100, "type": "array", "description": "Discovery mode. City names to find hotels in, e.g. \"Hong Kong\", \"Sanya\", \"Beijing\". Each city is resolved to its top hotels and every one is scraped. No city codes needed.", "items": { "type": "string" } }, "sortBy": { "title": "🔃 Sort reviews by", "enum": [ "newest", "recommended" ], "type": "string", "description": "Newest first (chronological, recommended) or Fliggy's own \"recommended\" ranking. Newest also lets the From-date cutoff stop early for fast incremental syncs.", "default": "newest" }, "maxReviews": { "title": "🔢 Max reviews per hotel", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Reviews mode. Maximum reviews to scrape per hotel/item (1-5000). Popular hotels have tens of thousands available.", "default": 200 }, "fromDate": { "title": "📅 From date", "type": "string", "description": "Only include reviews submitted on or after this date (YYYY-MM-DD). Fastest with \"Newest first\" sort, which stops the crawl as soon as it passes the cutoff." }, "includeReplies": { "title": "💬 Include reply threads", "type": "boolean", "description": "Also fetch the follow-up reply thread for reviews that have one (a small minority). Turning this on makes the run take a bit longer to finish.", "default": false }, "maxHotels": { "title": "🏨 Max hotels per city", "minimum": 1, "maximum": 100, "type": "integer", "description": "Discovery mode only. How many hotels to take from each city before scraping their reviews.", "default": 20 }, "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "Apify Proxy by default. Any exit works (a China IP is not required).", "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 } } } } } } } } } }