{ "openapi": "3.0.1", "info": { "title": "Weibo Scraper - Hot Search, Posts, Users & Comments", "description": "Scrape Weibo (微博): hot search ranking, trending posts, keyword search, user profiles and posts, full post text and comments. No login needed. IDs kept as strings, times in UTC. Export JSON, CSV, Excel.", "version": "1.0", "x-build-id": "KpnlRapQQ4k9os3Gw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/v1tal615~weibo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-v1tal615-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/v1tal615~weibo-scraper/runs": { "post": { "operationId": "runs-sync-v1tal615-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/v1tal615~weibo-scraper/run-sync": { "post": { "operationId": "run-sync-v1tal615-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": { "hotSearch": { "title": "Hot search list (热搜榜)", "type": "boolean", "description": "Get the current Weibo hot search ranking (about 50 topics with heat score and label). Great for scheduled trend tracking.", "default": false }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords or #hashtags# to search posts for, in Chinese or English.", "default": [], "items": { "type": "string" } }, "searchType": { "title": "Search results", "enum": [ "top", "latest" ], "type": "string", "description": "Top (综合, most relevant) or Latest (实时, newest first).", "default": "top" }, "users": { "title": "Users", "type": "array", "description": "Profile URLs (weibo.com/u/1669879400, m.weibo.cn/u/...), numeric user IDs or exact screen names. Returns the profile plus their latest posts.", "default": [], "items": { "type": "string" } }, "postUrls": { "title": "Post URLs or IDs", "type": "array", "description": "Post links (weibo.com//, m.weibo.cn/detail/), numeric post IDs or mblogids. Returns full post details.", "default": [], "items": { "type": "string" } }, "hotPosts": { "title": "Trending posts (热门微博)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How many posts to take from Weibo's trending feed (0 = off).", "default": 0 }, "maxResults": { "title": "Max posts per keyword / user", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper limit of posts for each search keyword and each user. Without a cookie Weibo shows guests only the first page (about 10 posts).", "default": 50 }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also scrape the hot comments (and their inline replies) of every post found.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Limit of comments + replies per post. Guests get the first page (about 20 comments).", "default": 50 }, "expandLongText": { "title": "Expand long posts", "type": "boolean", "description": "Weibo truncates long posts in lists; fetch the full text for them (one extra request per long post).", "default": true }, "weiboCookie": { "title": "Weibo cookie (optional)", "type": "string", "description": "Optional. The Cookie header of your own logged-in m.weibo.cn session, used only to go past the first page of searches, timelines and comments. Stored encrypted and only sent to weibo.cn." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed in most cases: the scraper switches to Apify Proxy on its own if Weibo blocks it.", "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 } } } } } } } } } }