{ "openapi": "3.0.1", "info": { "title": "Douyin & Weibo Hot Search Scraper: China Trending Topics", "description": "China's hot search lists in one run: Douyin, Weibo, Baidu and Toutiao. Rank, heat, badge, category, link and cover for every topic, rank changes since your last run, optional English translation. No login. Lists that could not be read are not charged.", "version": "0.1", "x-build-id": "28tXPJxU08IFbVojY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quarra~douyin-weibo-hot-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quarra-douyin-weibo-hot-search-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/quarra~douyin-weibo-hot-search-scraper/runs": { "post": { "operationId": "runs-sync-quarra-douyin-weibo-hot-search-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/quarra~douyin-weibo-hot-search-scraper/run-sync": { "post": { "operationId": "run-sync-quarra-douyin-weibo-hot-search-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": { "boards": { "title": "Hot lists", "type": "array", "description": "Which lists to read. Each list is read once per run, as it stands at that minute.", "items": { "type": "string", "enum": [ "douyin", "weibo", "baidu", "toutiao" ], "enumTitles": [ "Douyin hot search (抖音热榜)", "Weibo hot search (微博热搜)", "Baidu hot search (百度热搜)", "Toutiao hot list (头条热榜)" ] }, "default": [ "douyin", "weibo" ] }, "maxItemsPerBoard": { "title": "Topics per list", "minimum": 1, "maximum": 60, "type": "integer", "description": "Ranked topics taken from the top of each list (the lists hold about 50). Pinned topics and Douyin's rising topics come on top of this number when they are included.", "default": 50 }, "includeRising": { "title": "Douyin rising topics", "type": "boolean", "description": "Also return the topics Douyin shows as rising right now (usually 5), with list = \"rising\".", "default": true }, "includePinned": { "title": "Pinned topics", "type": "boolean", "description": "Topics the platform pins above the ranking (official topics on Weibo, Baidu and Toutiao). They have no rank.", "default": true }, "includePromoted": { "title": "Promoted topics", "type": "boolean", "description": "Paid placements inside Weibo's list, marked isPromoted. Left out by default.", "default": false }, "translateToEnglish": { "title": "English translation", "type": "boolean", "description": "Adds titleEnglish (and descriptionEnglish for Baidu). A translated topic is charged as a translated topic instead of a topic. Available on paid Apify plans only.", "default": false }, "trackRankChanges": { "title": "Rank changes since the last run", "type": "boolean", "description": "Compares each list with the last run that had this option on, under the same history key: previousRank, rankChange (positive = moved up) and isNew. Useful on a schedule.", "default": true }, "historyKey": { "title": "History key", "type": "string", "description": "Name of the history the comparison uses. Give each schedule its own key if you run several (letters, digits, - and _).", "default": "default" }, "maxItems": { "title": "Max topics", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Total number of topics delivered by the run, counted exactly. Empty = no limit beyond the lists themselves." }, "proxyConfiguration": { "title": "Connection", "type": "object", "description": "Connection. Keep the default (automatic). Costs are included in the price.", "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 }, "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 } } } } } } } } } }