{ "openapi": "3.0.1", "info": { "title": "Mafengwo 马蜂窝 Tours & Tickets Scraper | Prices & Units Sold", "description": "Collect every tour, ticket, pass and day trip a Chinese destination sells on Mafengwo (马蜂窝): prices in yuan, the seller, the attraction IDs each product covers, and sales counts and buyer ratings where the listing carries them. Paste a link, an ID or a city name.", "version": "0.0", "x-build-id": "JmkMEeHKg98JinmUa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~mafengwo-tours-tickets-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-mafengwo-tours-tickets-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~mafengwo-tours-tickets-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-mafengwo-tours-tickets-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~mafengwo-tours-tickets-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-mafengwo-tours-tickets-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": { "destinations": { "title": "Paste destination links / IDs / names", "type": "string", "description": "Paste Mafengwo destination links, destination IDs, or Chinese city names such as 北京. One per line, or separated by commas or semicolons; spaces are not separators, so a name such as Hong Kong stays one entry. Names are matched in Chinese; a romanised name usually does not match. Anything that is not a destination is skipped and reported at the start of the run. Place links are not used here, because tours and tickets are sold per destination: put a place or theme in Search terms instead." }, "keywords": { "title": "Search terms (optional)", "type": "string", "description": "One search term per line, in Chinese, for example 黄鹤楼 or 温泉. A term searches the whole catalogue rather than one city, so it also finds products sold from other destinations. Each term is processed alongside the others and has its own Maximum products allowance, so the work grows with the number of terms; up to 50 terms are used per run. Terms are not counted against Maximum destinations, and a run can use terms alone with no destination." }, "startUrls": { "title": "Additional links (optional)", "type": "array", "description": "Optional structured list of Mafengwo destination links. Combined with the paste box above and deduplicated, with neither field taking precedence. For destination IDs or names, use the paste box. Lists loaded from a file are not supported.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "productTypes": { "title": "Product types", "type": "array", "description": "Limit the results to certain kinds of product. Several choices combine their results without duplicates, and Maximum products still applies to the destination as a whole rather than to each type. Leave empty for every kind, which is also the fastest way to collect a destination in full.", "items": { "type": "string", "enum": [ "customized", "one_day_tour", "multi_day_tour", "ticket", "local_play", "cruise", "package_tour" ], "enumTitles": [ "Custom trips", "Day trips", "Local multi-day tours", "Tickets", "Local experiences", "Cruises", "Package tours" ] } }, "maxProducts": { "title": "Maximum products", "minimum": 0, "type": "integer", "description": "Stop after this many products for each destination and each search term. Every saved product is charged as one result, so this is the setting that controls what a run costs. Use 0 for everything the destination has, which was around 1,800 products for a large city." }, "maxDestinations": { "title": "Maximum destinations", "minimum": 1, "type": "integer", "description": "Maximum number of destinations to process. Links and IDs are taken first, then typed names, and any beyond this number are left out. Search terms are not counted against this." } } }, "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 } } } } } } } } } }