{
  "openapi": "3.0.1",
  "info": {
    "title": "Weibo Scraper 微博 — Search, Hot Search, Posts, Comments & Users",
    "description": "Scrape Weibo (微博) without login: keyword search in 6 tabs, the 热搜 hot search list, trending posts, posts by URL with full text, comments and replies with IP location, user profiles and latest posts. From $0.50 per 1,000 rows.",
    "version": "0.1",
    "x-build-id": "R8ycYQJCyshHzYYiX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/china-data~weibo-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-china-data-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/china-data~weibo-scraper/runs": {
      "post": {
        "operationId": "runs-sync-china-data-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/china-data~weibo-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-china-data-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": {
          "searchQueries": {
            "title": "Search keywords (搜索关键词)",
            "type": "array",
            "description": "Search Weibo for these keywords, brands, names or #topics#, in Chinese or English. Each keyword is searched in every tab chosen below and each post is saved once.",
            "items": {
              "type": "string"
            }
          },
          "searchTabs": {
            "title": "Search tabs",
            "type": "array",
            "description": "Weibo shows visitors who are not logged in the first page of each search tab, so more tabs give more posts: about 15 from All, 10 from Real-time, 10 from Hot, 15 from Video, 50 from Pictures and 15 from the #topic# page; together about 90 different posts per keyword.",
            "items": {
              "type": "string",
              "enum": [
                "all",
                "realtime",
                "hot",
                "video",
                "pictures",
                "topic"
              ],
              "enumTitles": [
                "All 综合",
                "Real-time (newest) 实时",
                "Hot 热门",
                "Video 视频",
                "Pictures 图片",
                "#Topic# page 话题"
              ]
            },
            "default": [
              "all",
              "realtime",
              "hot",
              "video",
              "pictures",
              "topic"
            ]
          },
          "maxPostsPerQuery": {
            "title": "Max posts per keyword",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Posts are charged per row, so this also caps the cost per keyword.",
            "default": 100
          },
          "includeHotSearch": {
            "title": "Hot search list (热搜榜)",
            "type": "boolean",
            "description": "Save the current real-time hot search list: about 50 topics with rank, heat, label (新 / 热 / 沸 / 爆), category and the time each topic entered the list, plus the pinned topic. Paid entries are left out. Schedule the actor to track how topics rise and fall.",
            "default": false
          },
          "hotFeedPosts": {
            "title": "Trending posts (热门微博)",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Save this many posts from Weibo's trending feed. 0 turns it off.",
            "default": 0
          },
          "postUrls": {
            "title": "Post URLs or IDs (微博链接)",
            "type": "array",
            "description": "Full details of specific posts. Accepts weibo.com/<user>/<id>, m.weibo.cn/detail/<id>, m.weibo.cn/status/<id> and share links, or a bare post ID (mid or mblogid).",
            "items": {
              "type": "string"
            }
          },
          "users": {
            "title": "Users (用户)",
            "type": "array",
            "description": "Profiles to save: a numeric user ID, a profile link (weibo.com/u/<id>, weibo.com/n/<nickname>, weibo.com/<custom name>, m.weibo.cn/u/<id>) or an exact nickname. Each gives a profile row with follower, post and interaction counts.",
            "items": {
              "type": "string"
            }
          },
          "includeUserPosts": {
            "title": "Latest posts of each user",
            "type": "boolean",
            "description": "Also save each user's latest posts. Weibo shows visitors who are not logged in the 10 newest posts of a profile, plus its pinned posts (isPinned = true).",
            "default": true
          },
          "includeComments": {
            "title": "Comments (评论)",
            "type": "boolean",
            "description": "Save the comments of every post as separate rows (type = comment): text, likes, reply count, date, IP location and commenter. Weibo shows visitors who are not logged in about the first 300 comments of a post.",
            "default": false
          },
          "commentsSort": {
            "title": "Comment order",
            "enum": [
              "hot",
              "latest"
            ],
            "type": "string",
            "description": "Which comments come first: the most-liked ones (hot) or the newest ones (latest).",
            "default": "hot"
          },
          "maxCommentsPerPost": {
            "title": "Max comments per post",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Comments are charged per row, so this also caps the cost per post.",
            "default": 20
          },
          "includeReplies": {
            "title": "Replies to comments (楼中楼)",
            "type": "boolean",
            "description": "Also save the replies under each comment (isReply = true, linked by rootCommentId). Replies are charged as comments.",
            "default": false
          },
          "maxRepliesPerComment": {
            "title": "Max replies per comment",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How many replies to save under each top-level comment. Replies are saved as comment rows with isReply = true.",
            "default": 10
          },
          "fullText": {
            "title": "Full text of long posts",
            "type": "boolean",
            "description": "Search results and user timelines cut long posts short. When on, the actor gets the complete text (one extra request per long post, no extra charge).",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Weibo answers visitors without a proxy, so none is used by default. If Weibo starts refusing requests, the actor switches to Apify Proxy by itself.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}