{ "openapi": "3.0.1", "info": { "title": "China Hot Lists: Douyin, Weibo, Baidu, Bilibili, Zhihu", "description": "Full top-N snapshots of Chinese trending boards with no keywords needed. Per-board status, heat in native units, ad and pinned flags, board update time and cache age.", "version": "0.3", "x-build-id": "PEzUsBYeu4hftXSFf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sergeyfaraday~china-hot-lists/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sergeyfaraday-china-hot-lists", "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/sergeyfaraday~china-hot-lists/runs": { "post": { "operationId": "runs-sync-sergeyfaraday-china-hot-lists", "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/sergeyfaraday~china-hot-lists/run-sync": { "post": { "operationId": "run-sync-sergeyfaraday-china-hot-lists", "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": { "boards": { "title": "Boards", "type": "array", "description": "Boards to snapshot. Default: six boards (Douyin hot, Douyin rising, Weibo, Baidu, Bilibili hot search, Zhihu).", "items": { "type": "string", "enum": [ "douyin_hot", "douyin_rising", "weibo_hot", "baidu_hot", "bilibili_hot_search", "bilibili_popular", "zhihu_hot", "toutiao_hot" ], "enumTitles": [ "Douyin hot list (抖音热榜)", "Douyin rising (实时上升热点)", "Weibo hot search (微博热搜)", "Baidu hot search (百度热搜)", "Bilibili hot search (热搜)", "Bilibili popular videos (综合热门)", "Zhihu hot list (知乎热榜)", "Toutiao hot board (头条热榜)" ] }, "default": [ "douyin_hot", "douyin_rising", "weibo_hot", "baidu_hot", "bilibili_hot_search", "zhihu_hot" ] }, "topN": { "title": "Top N per board", "minimum": 1, "maximum": 200, "type": "integer", "description": "Keep ranked rows with position <= N. Pinned and ad rows are always kept and flagged. The board size the platform showed is reported per board.", "default": 50 }, "staleAfterMinutes": { "title": "Stale after (minutes)", "minimum": 5, "type": "integer", "description": "Flag a board as stale when its own update time (Douyin active_time, Baidu updateTime) is older than this at fetch time: the manifest says so, and its rows carry data.stale=true. Boards with no such time have data.stale=null.", "default": 180 }, "staleIsPartial": { "title": "Stale board = partial", "type": "boolean", "description": "Mark a stale board as partial instead of ok (it is always flagged in the manifest).", "default": true }, "snapshotId": { "title": "Snapshot ID", "type": "string", "description": "Your id for this snapshot, one per task of one actor. Rows get recordKey = platform:type:id:snapshotId, so a repeat with the same snapshotId gives the same keys, and a new id gives a new observation. A repeat reads the source again: compare provenance.contentChecksum to see whether the values moved. Default: .." }, "queryId": { "title": "Query profile ID", "type": "string", "description": "Your search profile id, copied into provenance.queryId." }, "queryVersion": { "title": "Query profile version", "type": "string", "description": "Search profile version, copied into provenance.queryVersion." }, "panelId": { "title": "Panel ID", "type": "string", "description": "Fixed panel id for refresh runs, copied into provenance.panelId." }, "panelVersion": { "title": "Panel version", "type": "string", "description": "Panel composition version; a new composition must get a new version." }, "maxItems": { "title": "Max records", "minimum": 1, "type": "integer", "description": "Hard cap on dataset rows for this run. Separate from the run money cap (maxTotalChargeUsd), which is set on the run itself." }, "maxRunSeconds": { "title": "Soft time budget (s)", "minimum": 30, "type": "integer", "description": "Stop starting new units this many seconds after the run started and finish with a partial manifest. The budget belongs to the run: a restart does not renew it, and the time between workers counts." }, "keepRaw": { "title": "Keep raw upstream item", "type": "boolean", "description": "Store the raw upstream item in `raw`. Off by default. provenance.rawChecksum is present on rows built from a raw item; it is null on a state row with no answer behind it and on derived rows.", "default": false }, "failOnPartial": { "title": "Fail run on partial", "type": "boolean", "description": "By default a partial result finishes as SUCCEEDED with status=partial in the MANIFEST record. Failed and blocked always finish as FAILED.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy for upstream requests.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }