{
  "openapi": "3.0.1",
  "info": {
    "title": "Weibo 微博 Scraper - Hot Search, Posts, Comments & Users",
    "description": "Scrape Sina Weibo (微博): hot search list (微博热搜), keyword and date-range post search, post details, comments and replies with commenter IP location, reposts, reactions and user profiles. No login or cookies needed. For social listening and China market research. Export JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "yJeWlEsqtEfCNiaC1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clover_folktale~weibo-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clover_folktale-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/clover_folktale~weibo-scraper/runs": {
      "post": {
        "operationId": "runs-sync-clover_folktale-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/clover_folktale~weibo-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-clover_folktale-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "post",
              "comments",
              "user",
              "hot",
              "following",
              "reposts",
              "likes",
              "replies",
              "userSearch",
              "advancedSearch",
              "topicSearch",
              "videoSearch",
              "picSearch",
              "userVideos",
              "userPhotos",
              "userArticles",
              "rankings",
              "relatedSearches",
              "videoCollections",
              "recommendTimeline",
              "videoFeed",
              "homeFeed"
            ],
            "type": "string",
            "description": "What to scrape.",
            "default": "search"
          },
          "keyword": {
            "title": "Keyword (modes: search, userSearch, advancedSearch, topicSearch, videoSearch, picSearch, relatedSearches)",
            "type": "string",
            "description": "Search keyword. Chinese keywords return the best results.",
            "default": "特斯拉"
          },
          "posts": {
            "title": "Posts (modes: post, comments, reposts, likes)",
            "type": "array",
            "description": "Weibo post links or IDs, e.g. https://weibo.com/6593199887/Rlf5vlWRz or 5350628895231161.",
            "items": {
              "type": "string"
            }
          },
          "users": {
            "title": "Users (modes: user, following, userVideos, userPhotos, userArticles, videoCollections)",
            "type": "array",
            "description": "Weibo UIDs or profile links, e.g. 6593199887 or https://weibo.com/u/6593199887. Accounts that hide their following list return nothing and are not billed.",
            "items": {
              "type": "string"
            }
          },
          "includeReplies": {
            "title": "Include replies (mode: comments)",
            "type": "boolean",
            "description": "Also return the replies shown under each comment (the first replies the platform includes with the comment; long reply threads may be partial). Each reply is billed like a comment.",
            "default": false
          },
          "onlyOriginal": {
            "title": "Original posts only (mode: user)",
            "type": "boolean",
            "description": "Mode user: list only the posts the user wrote themselves (no reposts), about 49 per page. The profile item is still returned first.",
            "default": false
          },
          "commentIds": {
            "title": "Comment IDs (mode: replies)",
            "type": "array",
            "description": "Numeric comment IDs, e.g. the commentId of a comment returned by comments mode. Returns every reply under each comment.",
            "items": {
              "type": "string"
            }
          },
          "startDate": {
            "title": "Start date (mode: advancedSearch)",
            "type": "string",
            "description": "First day to search, like 2026-10-01. Set together with the end date, or leave both empty to search all time."
          },
          "endDate": {
            "title": "End date (mode: advancedSearch)",
            "type": "string",
            "description": "Last day to search (the whole day is included), like 2026-10-10."
          },
          "province": {
            "title": "Province (mode: userSearch)",
            "enum": [
              "",
              "安徽",
              "北京",
              "重庆",
              "福建",
              "甘肃",
              "广东",
              "广西",
              "贵州",
              "海南",
              "河北",
              "黑龙江",
              "河南",
              "湖北",
              "湖南",
              "内蒙古",
              "江苏",
              "江西",
              "吉林",
              "辽宁",
              "宁夏",
              "青海",
              "山西",
              "山东",
              "上海",
              "四川",
              "天津",
              "西藏",
              "新疆",
              "云南",
              "浙江",
              "陕西",
              "台湾",
              "香港",
              "澳门",
              "海外",
              "其他"
            ],
            "type": "string",
            "description": "Mode userSearch: only accounts located in this province. Leave empty for all regions.",
            "default": ""
          },
          "city": {
            "title": "City (mode: userSearch)",
            "enum": [
              "",
              "合肥",
              "芜湖",
              "蚌埠",
              "淮南",
              "马鞍山",
              "淮北",
              "铜陵",
              "安庆",
              "黄山",
              "滁州",
              "阜阳",
              "宿州",
              "巢湖",
              "六安",
              "亳州",
              "池州",
              "宣城",
              "东城区",
              "西城区",
              "崇文区",
              "宣武区",
              "朝阳区",
              "丰台区",
              "石景山区",
              "海淀区",
              "门头沟区",
              "房山区",
              "通州区",
              "顺义区",
              "昌平区",
              "大兴区",
              "怀柔区",
              "平谷区",
              "密云县",
              "延庆县",
              "万州区",
              "涪陵区",
              "渝中区",
              "大渡口区",
              "江北区",
              "沙坪坝区",
              "九龙坡区",
              "南岸区",
              "北碚区",
              "万盛区",
              "双桥区",
              "渝北区",
              "巴南区",
              "黔江区",
              "长寿区",
              "綦江县",
              "潼南县",
              "铜梁县",
              "大足县",
              "荣昌县",
              "璧山县",
              "梁平县",
              "城口县",
              "丰都县",
              "垫江县",
              "武隆县",
              "忠县",
              "开县",
              "云阳县",
              "奉节县",
              "巫山县",
              "巫溪县",
              "石柱土家族自治县",
              "秀山土家族苗族自治县",
              "酉阳土家族苗族自治县",
              "彭水苗族土家族自治县",
              "江津区",
              "合川市",
              "永川区",
              "南川市",
              "福州",
              "厦门",
              "莆田",
              "三明",
              "泉州",
              "漳州",
              "南平",
              "龙岩",
              "宁德",
              "兰州",
              "嘉峪关",
              "金昌",
              "白银",
              "天水",
              "武威",
              "张掖",
              "平凉",
              "酒泉",
              "庆阳",
              "定西",
              "陇南",
              "临夏",
              "甘南",
              "广州",
              "韶关",
              "深圳",
              "珠海",
              "汕头",
              "佛山",
              "江门",
              "湛江",
              "茂名",
              "肇庆",
              "惠州",
              "梅州",
              "汕尾",
              "河源",
              "阳江",
              "清远",
              "东莞",
              "中山",
              "潮州",
              "揭阳",
              "云浮",
              "南宁",
              "柳州",
              "桂林",
              "梧州",
              "北海",
              "防城港",
              "钦州",
              "贵港",
              "玉林",
              "百色",
              "贺州",
              "河池",
              "来宾",
              "崇左",
              "贵阳",
              "六盘水",
              "遵义",
              "安顺",
              "铜仁",
              "黔西南",
              "毕节",
              "黔东南",
              "黔南",
              "海口",
              "三亚",
              "其他",
              "石家庄",
              "唐山",
              "秦皇岛",
              "邯郸",
              "邢台",
              "保定",
              "张家口",
              "承德",
              "沧州",
              "廊坊",
              "衡水",
              "哈尔滨",
              "齐齐哈尔",
              "鸡西",
              "鹤岗",
              "双鸭山",
              "大庆",
              "伊春",
              "佳木斯",
              "七台河",
              "牡丹江",
              "黑河",
              "绥化",
              "大兴安岭",
              "郑州",
              "开封",
              "洛阳",
              "平顶山",
              "安阳",
              "鹤壁",
              "新乡",
              "焦作",
              "濮阳",
              "许昌",
              "漯河",
              "三门峡",
              "南阳",
              "商丘",
              "信阳",
              "周口",
              "驻马店",
              "武汉",
              "黄石",
              "十堰",
              "宜昌",
              "襄阳",
              "鄂州",
              "荆门",
              "孝感",
              "荆州",
              "黄冈",
              "咸宁",
              "随州",
              "恩施土家族苗族自治州",
              "长沙",
              "株洲",
              "湘潭",
              "衡阳",
              "邵阳",
              "岳阳",
              "常德",
              "张家界",
              "益阳",
              "郴州",
              "永州",
              "怀化",
              "娄底",
              "湘西土家族苗族自治州",
              "呼和浩特",
              "包头",
              "乌海",
              "赤峰",
              "通辽",
              "鄂尔多斯",
              "呼伦贝尔",
              "兴安盟",
              "锡林郭勒盟",
              "乌兰察布盟",
              "巴彦淖尔盟",
              "阿拉善盟",
              "南京",
              "无锡",
              "徐州",
              "常州",
              "苏州",
              "南通",
              "连云港",
              "淮安",
              "盐城",
              "扬州",
              "镇江",
              "泰州",
              "宿迁",
              "南昌",
              "景德镇",
              "萍乡",
              "九江",
              "新余",
              "鹰潭",
              "赣州",
              "吉安",
              "宜春",
              "抚州",
              "上饶",
              "长春",
              "吉林",
              "四平",
              "辽源",
              "通化",
              "白山",
              "松原",
              "白城",
              "延边朝鲜族自治州",
              "沈阳",
              "大连",
              "鞍山",
              "抚顺",
              "本溪",
              "丹东",
              "锦州",
              "营口",
              "阜新",
              "辽阳",
              "盘锦",
              "铁岭",
              "朝阳",
              "葫芦岛",
              "银川",
              "石嘴山",
              "吴忠",
              "固原",
              "中卫",
              "西宁",
              "海东",
              "海北",
              "黄南",
              "海南",
              "果洛",
              "玉树",
              "海西",
              "太原",
              "大同",
              "阳泉",
              "长治",
              "晋城",
              "朔州",
              "晋中",
              "运城",
              "忻州",
              "临汾",
              "吕梁",
              "济南",
              "青岛",
              "淄博",
              "枣庄",
              "东营",
              "烟台",
              "潍坊",
              "济宁",
              "泰安",
              "威海",
              "日照",
              "莱芜",
              "临沂",
              "德州",
              "聊城",
              "滨州",
              "菏泽",
              "黄浦区",
              "卢湾区",
              "徐汇区",
              "长宁区",
              "静安区",
              "普陀区",
              "闸北区",
              "虹口区",
              "杨浦区",
              "闵行区",
              "宝山区",
              "嘉定区",
              "浦东新区",
              "金山区",
              "松江区",
              "青浦区",
              "南汇区",
              "奉贤区",
              "崇明县",
              "成都",
              "自贡",
              "攀枝花",
              "泸州",
              "德阳",
              "绵阳",
              "广元",
              "遂宁",
              "内江",
              "乐山",
              "南充",
              "眉山",
              "宜宾",
              "广安",
              "达州",
              "雅安",
              "巴中",
              "资阳",
              "阿坝",
              "甘孜",
              "凉山",
              "和平区",
              "河东区",
              "河西区",
              "南开区",
              "河北区",
              "红桥区",
              "塘沽区",
              "汉沽区",
              "大港区",
              "东丽区",
              "西青区",
              "津南区",
              "北辰区",
              "武清区",
              "宝坻区",
              "宁河县",
              "静海县",
              "蓟县",
              "拉萨",
              "昌都",
              "山南",
              "日喀则",
              "那曲",
              "阿里",
              "林芝",
              "乌鲁木齐",
              "克拉玛依",
              "吐鲁番",
              "哈密",
              "昌吉",
              "博尔塔拉",
              "巴音郭楞",
              "阿克苏",
              "克孜勒苏",
              "喀什",
              "和田",
              "伊犁",
              "塔城",
              "阿勒泰",
              "石河子",
              "昆明",
              "曲靖",
              "玉溪",
              "保山",
              "昭通",
              "楚雄",
              "红河",
              "文山",
              "思茅",
              "西双版纳",
              "大理",
              "德宏",
              "丽江",
              "怒江",
              "迪庆",
              "临沧",
              "杭州",
              "宁波",
              "温州",
              "嘉兴",
              "湖州",
              "绍兴",
              "金华",
              "衢州",
              "舟山",
              "台州",
              "丽水",
              "西安",
              "铜川",
              "宝鸡",
              "咸阳",
              "渭南",
              "延安",
              "汉中",
              "榆林",
              "安康",
              "商洛",
              "台北",
              "高雄",
              "基隆",
              "台中",
              "台南",
              "新竹",
              "嘉义",
              "香港",
              "澳门",
              "美国",
              "英国",
              "法国",
              "俄罗斯",
              "加拿大",
              "巴西",
              "澳大利亚",
              "印尼",
              "泰国",
              "马来西亚",
              "新加坡",
              "菲律宾",
              "越南",
              "印度",
              "日本",
              "不限"
            ],
            "type": "string",
            "description": "Mode userSearch: narrow the province down to one city. Needs 'province' and must be a city of that province (for example 杭州 with 浙江). Leave empty for the whole province.",
            "default": ""
          },
          "rankingType": {
            "title": "Ranking (mode: rankings)",
            "enum": [
              "hour",
              "yesterday",
              "day_before",
              "week",
              "male",
              "female",
              "entertainment",
              "life",
              "social"
            ],
            "type": "string",
            "description": "Mode rankings: which list. hour = hot posts this hour, yesterday / day_before = hot posts of that day, week = hot posts this week, male / female = hot posts among male / female readers. entertainment, life and social = ranked topics of that area (about 50 each).",
            "default": "hour"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum number of items to return in total for this run. You are charged per item returned.",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}