微博公开数据 API | SandBase
用一个 REST API 读取微博公开的热搜、帖子和用户资料。无需微博 OAuth 应用,无需 SDK,一把 SandBase key,为 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,并指定一个任务。
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 逐字保留,属于历史示意材料,不是上面资料请求的响应:
{
"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 参数参考。保留自旧文,不是本次业务执行或端点复验。
串联调用之前
从趋势走到作者是一种可能的研究设计,不是本次修订已经证明可用的结果。追加端点之前,分别核对输入、业务结构、标识映射、可用性和费用;每一次都检查状态和载荷,不能整条链路只判断一次。
账号研究还存在原创帖游标矛盾: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,选择资料或普通帖子首页,校验结果后再扩大范围。历史热搜指导见专门教程。准备好后:
觉得有用?分享给更多人