{ "openapi": "3.0.1", "info": { "title": "Weibo Scraper - Hot Topics & Public Posts", "description": "Scrape Weibo hot topics without credentials, plus cookie-backed public Weibo keyword posts and user timelines into clean JSON datasets.", "version": "1.0", "x-build-id": "pe0MHe4QaReJTUxZM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~weibo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~weibo-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~weibo-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": { "mode": { "title": "Scraping mode", "enum": [ "hotTopics", "searchPosts", "userPosts" ], "type": "string", "description": "Use this when choosing which Weibo data surface to scrape. Accepted values are hotTopics, searchPosts, and userPosts; the default hotTopics mode needs no cookie and is best for public trend monitoring. searchPosts runs Weibo keyword post search and userPosts reads public posts from numeric user IDs, both requiring weiboCookie. This is not a comments, fan-list, private profile, or login automation mode.", "default": "hotTopics" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Use this when mode is searchPosts and the user wants public Weibo posts matching one or more keywords, such as '特斯拉' or 'OpenAI'. Enter plain keywords or hashtag text without URL encoding; the Actor submits each query to Weibo's mobile search endpoint. Defaults are not used by hotTopics or userPosts. This is not a user ID list, profile URL list, or private-message search.", "items": { "type": "string" }, "default": [ "特斯拉" ] }, "userIds": { "title": "User IDs or profile URLs", "type": "array", "description": "Use this when mode is userPosts and the user provides numeric Weibo user IDs or profile URLs like '2803301701' or 'https://m.weibo.cn/u/2803301701'. The Actor normalizes supported URLs to numeric IDs before requesting post timelines. Provide one or more values and keep maxPages modest for reliable runs. This is not a username lookup, follower graph, or private account extractor.", "items": { "type": "string" }, "default": [] }, "maxResults": { "title": "Maximum records", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of records to save across all requested Weibo sources. Enter an integer from 1 through 500; the default is 25. The Actor stops writing and charging after this cap, even if Weibo returns more data. This is a saved-record limit, not a guarantee that every query or user has that many public results.", "default": 25 }, "maxPages": { "title": "Maximum pages per source", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum Weibo API pages to request per search query or user ID. Enter an integer from 1 through 20; the default is 3 to keep cookie-backed runs short and agent-friendly. This field is ignored by hotTopics because the public hot-topic page is a single feed. This is not a retry count or browser scroll setting.", "default": 3 }, "weiboCookie": { "title": "Weibo SUB cookie", "type": "string", "description": "Cookie header from your own authorized Weibo browser session containing SUB=. Required only for searchPosts and userPosts because those routes are login-gated by Weibo. Paste the full cookie header, not a password; the value is secret and is never written to the dataset or summary. This is not an Apify API token, proxy credential, or permission to scrape private content." } } }, "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 } } }, "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 } } } } } } } } } }