{ "openapi": "3.0.1", "info": { "title": "Weibo Scraper - Hot Search, Trending Posts & Comments", "description": "Scrape Weibo (微博) Hot Search list (热搜榜), trending posts by category (finance, tech, society, celebrities…), post details, comments and public profiles. No login or cookies needed. Pay only per result.", "version": "0.1", "x-build-id": "Pdv5i9yMJVnEmiigk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kodenova~weibo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kodenova-weibo-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/kodenova~weibo-scraper/runs": { "post": { "operationId": "runs-sync-kodenova-weibo-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/kodenova~weibo-scraper/run-sync": { "post": { "operationId": "run-sync-kodenova-weibo-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": { "includeHotSearch": { "title": "Hot Search list (热搜榜)", "type": "boolean", "description": "Scrape the real-time Weibo Hot Search list (~50 topics): rank, keyword, heat, label (新/热/沸/爆), category. Ads are removed.", "default": true }, "trendingCategories": { "title": "Trending posts — categories", "type": "array", "description": "Collect trending posts (热门微博) from these channels.", "items": { "type": "string", "enum": [ "hot", "realtime", "society", "finance", "stocks", "tech", "digital", "cars", "international", "military", "law", "celebrities", "movies", "tvSeries", "variety", "music", "games", "anime", "sports", "fashion", "beauty", "food", "travel", "health", "realEstate", "home", "parenting", "education", "science", "history", "books", "pets", "funny", "shopping", "inDepth" ], "enumTitles": [ "热门 Hot (all)", "实时 Realtime", "社会 Society", "财经 Finance", "股市 Stocks", "科技 Tech", "数码 Digital", "汽车 Cars", "国际 International", "军事 Military", "法律 Law", "明星 Celebrities", "电影 Movies", "电视剧 TV series", "综艺 Variety shows", "音乐 Music", "游戏 Games", "动漫 Anime", "体育 Sports", "时尚 Fashion", "美妆 Beauty", "美食 Food", "旅游 Travel", "健康 Health", "房产 Real estate", "家居 Home", "育儿 Parenting", "校园 Campus", "科普 Science", "历史 History", "读书 Books", "萌宠 Pets", "搞笑 Funny", "好物 Shopping", "深度 In-depth" ] }, "default": [] }, "maxPostsPerCategory": { "title": "Max posts per category", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Weibo usually serves a few hundred trending posts per channel.", "default": 50 }, "postUrls": { "title": "Post URLs or IDs", "type": "array", "description": "Specific posts to scrape, e.g. https://weibo.com/1642634100/Rn7BXEcdh, https://m.weibo.cn/detail/5355108059580071 or the numeric ID. Long posts are returned in full.", "default": [], "items": { "type": "string" } }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also scrape comments of the posts above (trending and specific). Each comment is a separate result.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Top-level comments per post (hot order).", "default": 20 }, "includeReplies": { "title": "Include reply previews", "type": "boolean", "description": "Add the replies Weibo shows under each comment (usually 1–3).", "default": false }, "userIds": { "title": "User profiles (URLs or IDs)", "type": "array", "description": "Public profile info: name, bio, followers, posts count, verification. e.g. https://weibo.com/u/1642634100 or 1642634100.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max results (total)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Run stops after this many results in total. You only pay per result saved.", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Keep Apify Proxy on — Weibo's guest session server is not reachable without it.", "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 } } } } } } } } } }