{ "openapi": "3.0.1", "info": { "title": "Weibo Scraper - Comment Threads, Hot Search Ranks & User Stats", "description": "Get the comments and reply threads of any public Weibo (微博) post, with likes, IP location, floor and commenter, plus post details, user profile stats and the live hot search (热搜) ranking. No login, API-style JSON. $20 per 1,000 comments; deleted posts, unknown users and other errors are free.", "version": "1.0", "x-build-id": "aFWEML3Y4C2mOG0XZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~weibo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-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/tenfoldfleet~weibo-scraper/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-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/tenfoldfleet~weibo-scraper/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-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": { "postUrls": { "title": "Post URLs", "type": "array", "description": "Weibo posts to scrape: links like https://weibo.com//, m.weibo.cn/detail/ links, or a bare post id (9-character code such as RnoUCzlB3, or the 16-digit numeric id). Each post gives one post row (if 'Post details' is on) plus its comments.", "items": { "type": "string" } }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 0, "maximum": 300, "type": "integer", "description": "Top-level comments to collect per post, most-liked first. Weibo itself stops listing comments after about 300 per post for anyone not logged in, so 300 is the maximum. Set 0 for post details only.", "default": 100 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also collect the replies under each comment (the thread). Each reply is one comment result and is charged like a comment.", "default": false }, "maxRepliesPerComment": { "title": "Max replies per comment", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper limit of replies per comment when 'Include replies' is on. Replies come in pages of 20.", "default": 20 }, "includePostDetails": { "title": "Post details", "type": "boolean", "description": "Return one row per post with its text, time, repost/comment/like counts, pictures, video link, region and author. Turn off if you only want the comments.", "default": true }, "userIds": { "title": "Weibo users", "type": "array", "description": "Profiles to look up: numeric user ids (6 to 10 digits), links like https://weibo.com/u/, custom profile links like https://weibo.com/rmrb, or @screen name. One profile row each with followers, following, post count, verification and bio.", "items": { "type": "string" } }, "hotSearch": { "title": "Hot search board (热搜)", "type": "boolean", "description": "Snapshot of the Weibo hot search list: about 50 ranked topics with heat score, label (新, 热, 沸, 爆...), category and search link. Ads are skipped and never charged.", "default": false }, "popularFeed": { "title": "Popular feed", "type": "boolean", "description": "Posts from Weibo's public popular (热门) feed, with full counts and author. Paid ad posts are skipped and never charged.", "default": false }, "maxFeedPosts": { "title": "Max popular feed posts", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many popular feed posts to collect when 'Popular feed' is on.", "default": 50 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many posts or profiles to work on in parallel.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Default: Apify datacenter proxy, with an automatic residential fallback if Weibo blocks a datacenter IP. You don't need to change this.", "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 } } } } } } } } } }