{ "openapi": "3.0.1", "info": { "title": "Weibo Scraper — Posts, Profiles, Comments & Hot Search", "description": "Weibo scraper for posts, profiles, comments, likers, and realtime hot search. No API key: paste a mid, UID, or URL and get one flat dataset. Keyword search, fans, and following run only with your own logged-in cookie. Built for China social listening and creator research.", "version": "1.0", "x-build-id": "DriwgFKlaPnlNhsKV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~weibo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~weibo-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~weibo-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": { "operation": { "title": "Operation", "enum": [ "weiboDetail", "userDetail", "comments", "likers", "hotSearch", "searchWeibo", "userFans", "userFollowing" ], "type": "string", "description": "One job per run. Guest values, no Weibo login: weiboDetail (one post; example weiboId 5249718969175092), userDetail (one profile), comments, likers, hotSearch. Login values, cookie must include SUB=: searchWeibo, userFans, userFollowing. Default weiboDetail.", "default": "weiboDetail" }, "weiboId": { "title": "Weibo ID or URL", "type": "string", "description": "Post id for weiboDetail, comments, and likers. A numeric mid (example 5249718969175092), a bid such as QkRpSCuRm, or a URL such as https://m.weibo.cn/detail/5249718969175092. Ignored on profile, hot search, fans, and following. Prefill 5249718969175092." }, "userId": { "title": "User ID or URL", "type": "string", "description": "User id for userDetail, userFans, and userFollowing. A numeric UID (example 7961606632) or https://weibo.com/u/7961606632. Ignored on post, comments, likers, hot search, and keyword search. Prefill 7961606632." }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many pages to request for comments, likers, searchWeibo, userFans, and userFollowing. About 10 to 20 rows per page. Default 5. Minimum 1. Maximum 50. Ignored for weiboDetail, userDetail, and hotSearch.", "default": 5 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many dataset rows. Example 20. No default: comments and hot search keep going until maxPages or the end of the list. Set this on every agent run." }, "keyword": { "title": "Search keyword", "type": "string", "description": "Keyword for searchWeibo only. Chinese or English. Example 北京 or Tesla. Prefill 北京. Ignored on every other operation." }, "startDay": { "title": "Search start date", "type": "string", "description": "Earliest day for searchWeibo, format YYYY-MM-DD. Example 2026-08-22. Default is 30 days before today in Asia/Shanghai. Ignored unless operation is searchWeibo." }, "endDay": { "title": "Search end date", "type": "string", "description": "Latest day for searchWeibo, format YYYY-MM-DD. Example 2026-09-21. Default is today in Asia/Shanghai. Ignored unless operation is searchWeibo." }, "cookie": { "title": "Weibo cookie", "type": "string", "description": "Cookie header from a logged-in weibo.com tab. Required for searchWeibo, userFans, and userFollowing, and it must include SUB=. Example SUB=...; SUBP=.... Leave empty for weiboDetail, userDetail, comments, likers, and hotSearch." }, "proxy": { "title": "Proxy", "type": "object", "description": "Optional proxy override. Leave empty to use the actor's built-in residential proxy. To use Apify Proxy instead, pass {\"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 } } } } } } } } } }