微博公开数据 API | SandBase

用一个 REST API 读取微博公开的热搜、帖子和用户资料。无需微博 OAuth 应用,无需 SDK,一把 SandBase key,为 agent 工作流而生。

深色电影质感画面:微博热搜、帖子和资料数据经由单一 API 通道汇入 agent 核心

微博是中国公众舆论、明星新闻和热门话题最先冒头的地方,这让它的热搜榜、帖子流和资料数据在社交聆听、市场调研和 agent 工作流里格外有价值。但想用程序拿到这些数据,通常得逆向一个移动端 app、轮换 cookie,还要在网站每次改版时重建爬虫。

SandBase 的微博公开数据 API 把这层搭建成本去掉了。它通过普通 REST 端点读取微博公开的热搜、搜索结果、帖子和用户资料——一把 SandBase API key,不用微博登录,也不用 SDK。端点 API 参考是每个参数和响应信封的权威来源;下面展示的业务载荷字段名只是一个示例结构、并非保证的 schema,请以你所调端点的一份真实响应为准核对。

这不是新浪微博的官方开放平台。 如果你需要已认证的成员操作或一份授权的数据协议,请用微博官方 API;当你的流程需要的是公开、只读的数据(调研、监测)时,用 SandBase。想直接试?领取 SandBase API key,再浏览微博端点。

先说结论

  • 一个 API 读取微博公开的热搜、搜索结果、帖子、评论和用户资料。
  • 本文的 Model API 端点用 POST /v1/api/weibo/<path> 调用——只传该端点的参数,不用 SDK,一把 SANDBASE_API_KEY。
  • 端点以自然标识为入参:用户用 uid,帖子用 status_id/mid/id,搜索用 query/keyword。
  • 它只返回公开、只读数据。不能发帖、你这边不用登录、也拿不到私密或仅粉丝可见的数据;鉴权用 SandBase API key。

当前范围:已知账号的一次请求

保留的封面是概念插画,示意账号、数字和热搜标题不是 API 实测、当前榜单或模型性能数据。

2026-11-08 修订通过免费 inspect 和公开参考核对 user-info、user-posts,没有执行付费业务请求。下方较广的能力介绍和截图保留自 2026-09-27 发布、2026-10-01 更新的旧总览;热搜、搜索、详情和评论执行没有在本轮重新验证。

先选一个任务:用 uid 或 custom 二选一读取资料;或者用数字字符串 uid、page: 1、feature: 0 读取普通时间线首页,不传 since_id。后者可能包含转发,不是原创专用端点。账号教程提供经过离线测试的单次调用函数,以及已有 Key、已连接 Agent、新项目三种接入路径。

两个选定端点的基础价均为 $0.001,并符合组织共享的每日 100 次合资格调用额度,在 UTC 00:00 重置。本次没有查剩余额度或实际扣费,不能承诺一次请求必定免费成功。新增页面和其他端点需要分别核对契约与预算。

你到底需要哪个微博 API?

你的需求选择原因
发帖、以成员身份操作,或用账号授权数据微博官方平台成员和账号操作走微博官方。
读取公开的热搜、帖子或资料SandBase 微博公开数据 API普通 REST、一把 SandBase key、面向只读流程的结构化 JSON。
私密或仅粉丝可见的数据都不适用于公开流程这类数据不在本篇公开数据的范围内。

从微博 API 能拿到什么

整个目录横跨几个面(一个 app 面、一个 web 面,以及一个更新的 web-v2 面)。按用途归类:

  • 热搜与趋势 —— 实时热搜榜和趋势排行。
  • 搜索 —— 按关键词的实时搜索、话题搜索和高级搜索。
  • 帖子 —— 单条帖子的详情、评论、转发和点赞。
  • 用户 —— 按 uid 读取公开资料信息、时间线、视频和文章。

动手前请查每个端点的在线 API 参考,确认它所在的面和参数;可用性因端点而异。

历史微博目录概览 历史微博目录概览。保留自旧文,不是本次业务执行或端点复验。

微博提供的 vs. SandBase 补上的

公开数据来自微博,SandBase 不拥有或运营微博。统一鉴权可以简化接入,但每个端点仍需分别检查输入、业务响应与可用性。相同信封不能证明今天的热搜到资料链路可运行。当前首请求路线只读资料或一页普通时间线,然后停止。

快速上手:读取一个已知账号

用 Model API 的 POST 路径,不换成目录 GET 路径。在本地配置 SANDBASE_API_KEY,这个有限时的 cURL 只传 uid,不同时传 custom。它只打印响应,不替你验证业务成功。需要完整检查请用账号教程里的 Python;新项目可以把 SKILL.md 和 quickstart.md交给 Agent,并指定一个任务。

Shell
curl --fail-with-body --connect-timeout 10 --max-time 90 \
  -X POST https://api.sandbase.ai/v1/api/weibo/web-v2/user-info \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"uid":"1222135407"}'

检查已完成状态和 outputs[0].data 对象。资料参考包含 user 对象,教程另把对象非空作为本地完整性检查。若选择帖子任务,应检查整数 ok: 1、data 对象、对象数组 data.list。布尔值、缺失结构,以及外层 code: 200 的无效 UID 保存示例,都不能当作成功。可选计数缺失时保留未知,不补成零。

资料 README 原响应示例曾同时传两个标识,它仍是历史结构参考,不是本次二选一请求的执行证据。旧热搜 Python 保存在历史代码归档,其中失败结构回退空数组的写法不再作为当前建议。下面原热搜 JSON 逐字保留,属于历史示意材料,不是上面资料请求的响应:

JSON
{
  "id": "cb805c67-4817-4926-9639-24a15e694cc9",
  "status": "completed",
  "model": "weibo/web-v2/hot-search",
  "outputs": [
    {
      "data": {
        "realtime": [
          { "rank": 0, "word": "…", "note": "…", "num": 1172365 }
        ]
      }
    }
  ]
}

非 completed 状态就应停止首请求流程,不依赖错误体细节,也不回退为空数据。信封相同仍要按端点分别检查业务结构。

历史热搜参数参考 历史热搜参考。旧画面的生成 cURL 带有 model 字段,不要复制进当前只传端点参数的请求;这不是本次业务执行或端点复验。

能力地图

下表保留旧总览的历史导航,本轮只核对 user-info 和 user-posts,其余端点输入与当前执行未复验。

能力簇代表端点典型用途
热搜weibo/web-v2/hot-search热门话题监测
实时搜索weibo/web-v2/realtime-search话题与关键词发现
用户资料weibo/web-v2/user-basic-info按 uid 的公开账号信号
帖子详情weibo/app/status-detail按 status_id 读单条帖子
帖子评论weibo/app/status-comments互动与情感分析输入

分页方式因端点而异——若干端点接受一个页码或游标类的请求参数。具体看每个端点的 schema。

历史 user-basic-info 参数参考 历史 user-basic-info 参数参考。保留自旧文,不是本次业务执行或端点复验。

串联调用之前

从趋势走到作者是一种可能的研究设计,不是本次修订已经证明可用的结果。追加端点之前,分别核对输入、业务结构、标识映射、可用性和费用;每一次都检查状态和载荷,不能整条链路只判断一次。

账号研究还存在原创帖游标矛盾:schema 说初始 since_id 从 user-posts 获取,README 却谈后续分页,cURL 又省略 token。教程中 2026-10-01 的无 token 成功实验不能解决当前冲突。不要猜起始值,也不要悄悄增加前置调用。如果普通时间线首页满足需求,就先读取这一页,并区分转发和原创。

常见用例

用微博热搜 API 做趋势监测

按计划定时轮询 weibo/web-v2/hot-search 追踪实时榜单——每一项带一个排名关键词和一个热度数字。输入:无。输出:排名的热门话题列表。端点:hot-search。完整工作流看如何监测微博热搜。

用微博搜索 API 做话题发现

用一个 query 调 weibo/web-v2/realtime-search,围绕某话题挖出帖子。输入:query。输出:匹配帖子。端点:realtime-search。

用微博资料 API 做账号调研

用 weibo/web-v2/user-info 读取公开资料,uid、custom 二选一。返回数值 followers_count 时再读取,缺失则保留未知。旧的轻量 basic-info 观察没有数值粉丝量,本轮也未复验该端点。当前资料/帖子首请求与单独注明日期的原创帖实验见微博账号发帖研究教程。

首次读取后保留什么

把选定端点、输入标识、观察时间与返回载荷一起保存。数字零、明确 false、null、缺失字段各有含义,不要混为一谈。粉丝数不是触达量,一页时间线不是完整历史,媒体 URL 也不是已验证的下载结果。

根据第一份响应判断研究问题是否有足够依据。资料可帮助确认公开账号,帖子首页可展示样本和可用计数;两者都不能单独证明完整推广排名、原创全量集合或赞助分类。扩大范围之前,先检查未知项和下一次请求的预算。

边界与限制

  • 只读、公开数据。 不能发帖、关注,也拿不到私密/仅粉丝可见的数据。
  • 速率与量级。 出错就停,确认原因和预算后再决定是否重发;首请求示例不自动重试。
  • 参数与结构随上游而定。 标识各异(uid、status_id/mid/id、query/keyword);分页是各端点自己的请求参数。先看真实响应、读 schema。
  • 对照在线参考确认端点。 可用性和字段可能变化;在依赖某个具体端点之前先确认。
  • 这不是微博官方合作。 SandBase 只是提供对公开数据的统一访问;请遵守微博的条款以及你使用场景下适用的规则。

常见问题

我需要微博开发者应用或登录吗? 不需要。你用 SANDBASE_API_KEY 向 SandBase 鉴权。这些读取端点不需要微博账号或你这边的 OAuth。

用什么来标识用户或帖子? 用自然标识:用户用 uid,帖子用 status_id/mid/id。搜索用 query 或 keyword。

分页怎么做? 取决于端点——若干端点接受各自的页码或游标请求参数。具体看每个端点的 schema。

能读私密或仅粉丝可见的数据吗? 不能。这个 API 只返回公开数据。私密账号和仅粉丝可见的内容都不在范围内。

从一个已知账号开始

配置或复用 Key,选择资料或普通帖子首页,校验结果后再扩大范围。历史热搜指导见专门教程。准备好后:

觉得有用?分享给更多人