微博 API
30 个接口覆盖微博热搜榜、用户主页、博文、评论、视频与搜索，每个都只需一次 POST，返回结构化 JSON。实时的中文社交与舆情数据，海外社交平台 API 无法覆盖。无需微博应用，无需登录，也无需自己维护任何数据采集程序。
注册即送 50 积分。无需绑卡，无需微博应用，无需登录。
{ "data": { "user": { "uid": "7277477906", "nickname": "喝多的学姐", "description": null, "followers_count": 436357, "following_count": 341, "statuses_count": 20985, "avatar": "https://tvax2.sinaimg.cn/crop.0.0.1080.1080.1024/007WvyrUly1i6hjoob2z4j30u00u0gmj.jpg", "verified": true, "verified_reason": "娱乐博主 微博原创视频博主", "gender": "f", "location": "其他", "profile_url": "/u/7277477906" } }, "response_time": 1441, "credits_used": 1, "credits_remaining": 6999}这是该接口返回的真实响应。注册后即可自己调用。
什么是 Scavio 微博 API？
Scavio 微博 API 是一个以结构化 JSON 返回微博公开数据的 REST API。您用 API 密钥向 30 个接口之一发送 POST 请求，传入实时热搜榜、用户 id 或个性域名、博文 id 或搜索关键词，即可获得热点话题、用户主页、博文、评论、视频和搜索结果。无需微博应用，无需 OAuth，无需登录，每次调用消耗 1 积分。
- 30
- 个接口，全部已在生产环境上线
- 1
- 积分 / 次调用，所有接口统一价格
- 0
- 个微博应用或登录要求
从这四个接口开始
它们覆盖了大多数使用场景。全部 30 个接口见下表。
热搜榜
POST /api/v1/weibo/hot-search实时的微博热搜榜：每个热搜词附排名、热度值和标签。一次调用即可拿到实时的中文舆情数据，这是任何海外社交平台 API 都提供不了的。
用户主页
POST /api/v1/weibo/user/info按数字 uid 或个性域名查询昵称、粉丝数 / 关注数 / 微博数、认证状态与认证原因、性别和所在地。
博文与评论
POST /api/v1/weibo/post完整的博文详情，含转发数、评论数和点赞数，以及下方的评论串，每位评论者的主页资料一并返回。
关键词搜索
POST /api/v1/weibo/search/realtime任意关键词下的最新微博，附作者、发布设备和媒体，是了解当下舆论最快的方式。把 id 传给博文详情接口即可获取互动数据。
全部 30 个微博接口
所有接口都是 POST，返回 JSON，使用同一个 API 密钥。每次成功调用消耗 1 积分，没有按接口加价。
| 接口 | 返回数据 | 积分 |
|---|---|---|
热搜榜/api/v1/weibo/hot-search | 实时热搜榜：每个热搜词的排名、热度值和标签（如“大促”、商业推广） | 1 |
热搜置顶/api/v1/weibo/hot-search/index | 按榜单顺序返回置顶的热搜条目 | 1 |
用户信息/api/v1/weibo/user/info | 按 uid 或个性域名查询主页：昵称、粉丝数 / 关注数 / 微博数、认证标识与认证原因、性别、所在地、头像 | 1 |
用户详细信息/api/v1/weibo/user/info-detail | 核心信息之外的用户扩展主页字段 | 1 |
用户博文/api/v1/weibo/user/posts | 用户的微博时间线：博文 id、mblogid、正文、发布时间、发布地区、转发数 / 评论数 / 点赞数、图片和视频 | 1 |
用户原创博文/api/v1/weibo/user/original-posts | 与时间线结构相同，只保留原创（非转发）微博 | 1 |
用户粉丝/api/v1/weibo/user/fans | 用户的粉丝：uid、昵称、认证标识、头像、各项计数 | 1 |
用户关注/api/v1/weibo/user/following | 用户关注的账号，结构与粉丝列表相同 | 1 |
用户视频/api/v1/weibo/user/videos | 用户发布的视频：标题、封面、时长、互动数据 | 1 |
用户视频合集列表/api/v1/weibo/user/video-collections | 用户的视频合集及其合集 id | 1 |
视频合集/api/v1/weibo/user/video-collection | 按合集 id 返回某个合集中的视频 | 1 |
用户博文搜索/api/v1/weibo/user/search-posts | 在单个用户的微博中按关键词、时间范围和媒体类型筛选搜索 | 1 |
推荐时间线/api/v1/weibo/user/recommend-timeline | 推荐的首页博文时间线 | 1 |
博文详情/api/v1/weibo/post | 按 id 返回单条微博：正文、发布时间、发布地区、转发数 / 评论数 / 点赞数、图片列表、视频和作者信息 | 1 |
博文评论/api/v1/weibo/post/comments | 一级评论：评论 id、正文、点赞数和回复数、楼层号，以及完整的评论者主页资料 | 1 |
博文子评论/api/v1/weibo/post/sub-comments | 微博评论下嵌套的回复 | 1 |
博文点赞/api/v1/weibo/post/likes | 点赞该微博的账号 | 1 |
博文转发/api/v1/weibo/post/reposts | 微博的转发列表，含每位转发者及其转发时附加的文字 | 1 |
高级搜索/api/v1/weibo/search/advanced | 关键词搜索，支持类型、媒体类型和自定义时间范围筛选 | 1 |
实时搜索/api/v1/weibo/search/realtime | 关键词下的最新微博：id、正文、发布时间、博文链接、发布设备、作者和媒体 | 1 |
视频搜索/api/v1/weibo/search/videos | 匹配关键词的视频，支持热门或全部模式 | 1 |
用户搜索/api/v1/weibo/search/users | 匹配关键词的用户：uid、昵称、粉丝数、认证标识，可选地区 / 性别 / 年龄筛选 | 1 |
话题搜索/api/v1/weibo/search/topics | 匹配关键词的话题（# 话题 #） | 1 |
图片搜索/api/v1/weibo/search/pics | 匹配关键词的图片微博 | 1 |
相关搜索/api/v1/weibo/search/similar | 与关键词相关的搜索词和账号 | 1 |
AI 搜索/api/v1/weibo/search/ai | 针对自然语言问题返回 AI 辅助生成的回答 | 1 |
热门微博榜/api/v1/weibo/rankings/hot-timeline | 按小时或按天统计的热门微博 | 1 |
文娱榜/api/v1/weibo/rankings/entertainment | 文娱榜单 | 1 |
生活榜/api/v1/weibo/rankings/life | 生活榜单 | 1 |
社会榜/api/v1/weibo/rankings/social | 社会榜单 | 1 |
注册赠送的 50 积分可在任意接口组合中调用 50 次。 查看套餐
一次调用读取微博热搜榜
发送空的请求体，即可拿到实时热搜榜：每个热搜词附排名、热度值和标签。右侧的响应是真实抓取的结果，字段名完全一致。
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
board = client.weibo.hot_search()["data"]["trending"]
for entry in board[:10]:
label = f" [{entry['label']}]" if entry["label"] else ""
print(entry["rank"], entry["word"], entry["hot"], label){
"data": {
"trending": [
{ "word": "披荆斩棘淘汰", "note": "披荆斩棘淘汰", "hot": 98962, "rank": 0, "category": null, "label": null },
{ "word": "桃酥是没有一滴水的", "note": "桃酥是没有一滴水的", "hot": 68803, "rank": 1, "category": null, "label": null },
{ "word": "孙天宇空降上海京东MALL", "note": "孙天宇空降上海京东MALL", "hot": 68098, "rank": 2, "category": null, "label": "大促" }
]
},
"response_time": 1120,
"credits_used": 1,
"credits_remaining": 6999
}为什么不自己开发？
微博没有面向公开数据的开放接口，开放平台对海外开发者也基本不开放。剩下的选择是自己长期开发维护，或者调用一个接口。
自己开发
- 没有可以申请的微博公开 API，开放平台对大多数开发者并不开放
- 中文页面结构经常变化，需要不断跟进适配
- 热搜、榜单、评论和搜索都要分别单独开发
- 需要自己部署、监控，并在网站变化时随时修复
Scavio 微博 API
- 注册即发放 API 密钥，无需微博应用、无需审核、无需等待
- 热搜榜、任意用户主页、博文、评论串或搜索，一次 POST 即可
- 中文原文、编码正确，JSON 结构稳定
- 与 Scavio 其他 30 个平台使用同一个密钥和 JSON 结构，每次调用 1 积分
Scavio 只返回公开可获取的数据，从不以微博用户身份登录。
开发者用它做什么
实时趋势与舆情监测
定时拉取热搜榜和各类榜单，并保存每一次快照，就能得到全国热点按小时变化的完整记录，而且是可以直接排序分析的结构化 JSON。
hot-search + rankings/*品牌与产品舆情监听
用实时搜索和高级搜索追踪您的品牌、产品或竞品名称，并对比不同时间的结果。每条结果都带博文 id、作者、发布设备和媒体；对需要保留的博文，再用博文详情补充转发数、评论数和点赞数。
search/realtime + search/advanced + postKOL 与创作者研究
把个性域名解析为粉丝数、关注数、微博数和认证状态，再逐页读取该账号的博文和视频合集。用真实的影响力数据建立达人库，不再依赖截图。
user/info + user/posts + user/videos评论挖掘与情感分析
获取博文详情及其评论串，再把中文文本交给大模型，提炼主题、投诉或购买意向。每条评论都附结构化的作者信息和点赞数据。
post + post/comments话题追踪
搜索活动话题和相关图片，并通过热门微博榜观察讨论如何扩散。适用于新品发布追踪、活动报道和市场进入研究。
search/topics + rankings/hot-timelineAI 智能体工具与 RAG 流程
把 AI 智能体接入远程 MCP 服务器，微博就和 Scavio 的其他平台一样成为可调用的工具：同一个密钥、同一种 JSON 结构，无需为每个平台单独适配。
MCP + REST如何以 JSON 获取微博数据
- 1
获取 API 密钥
注册 Scavio 账号，在控制台复制您的密钥。注册即送 50 积分，无需绑卡。
- 2
向微博接口发送 POST 请求
热搜榜和各类榜单的请求体为空：带上 Authorization: Bearer 请求头，向 https://api.scavio.dev/api/v1/weibo/hot-search 发送 {} 即可。用户接口接收 uid 或个性域名，博文接口接收博文 id，搜索接口接收关键词。所有微博接口都是 POST。
- 3
读取 JSON
响应把数据放在 data 字段下，并附带 response_time、credits_used 和 credits_remaining。文本字段为中文原文，时间戳为北京时间（+0800）。
微博 API 常见问题
Scavio 微博 API 是什么？
+
这是一个以结构化 JSON 返回微博（新浪微博）公开数据的 REST API。30 个 POST 接口覆盖实时热搜榜和各类榜单、用户主页及其博文、粉丝与关注、视频与视频合集、单条博文详情、评论与子评论、点赞与转发，以及八种搜索。您只需使用 Scavio 的 API 密钥进行认证，无需处理任何微博账号凭证。
能获取微博热搜榜吗？
+
可以，这是最核心的接口。热搜榜接口返回实时榜单，包含每个热搜词、排名、热度值以及标签（例如“大促”或商业推广标记）。另有返回置顶条目的热搜置顶接口，以及文娱榜、生活榜、社会榜和热门微博榜。定时调用即可建立全国热点按小时变化的记录。
能从微博用户和博文中获取哪些数据？
+
用户方面：昵称、粉丝数 / 关注数 / 微博数、认证标识与认证原因、性别、所在地和头像，以及用户的博文时间线、仅原创博文、粉丝、关注、视频和视频合集。博文方面：正文、发布时间、发布地区、转发数 / 评论数 / 点赞数、图片列表和视频、作者信息，并可单独获取一级评论、嵌套的子评论、点赞账号和转发账号。
需要微博账号、开放平台应用或登录吗？
+
不需要。微博没有面向这类公开数据的开放接口，微博开放平台对海外开发者也基本不开放。使用 Scavio 无需这些：注册、拿到密钥、发送 id、个性域名或关键词即可。您不必注册微博应用，也不必保存任何登录信息。
每次请求多少钱？
+
每个微博接口每次成功调用消耗 1 积分，全部 30 个接口统一价格，包括热搜榜和所有搜索。新账号注册即送 50 积分（一次性），无需绑卡。付费套餐每月 30 美元起，含 7,000 积分，每次微博调用的成本不到 1 美分。
返回的文本是中文吗？
+
是的。博文正文、昵称、热搜词和评论均按微博上的原样返回中文，统一使用 UTF-8 编码（包括表情符号）。时间戳为北京时间（+0800）。如需翻译或转写拼音，请在收到数据后自行处理。
如何搜索微博博文？
+
实时搜索返回某个关键词下的最新微博，每条结果包含 id、正文、发布时间、博文链接、发布设备、作者和媒体；用 id 调用博文详情即可获取转发数、评论数和点赞数。需要按类型、媒体类型或自定义时间范围筛选时，请使用高级搜索。此外还有视频、用户、话题和图片的专用搜索接口，以及相关搜索词接口和 AI 搜索。所有搜索接口都接收关键词，每次消耗 1 积分。
能读取私密账号或受保护的微博吗？
+
不能。只返回微博公开可见的数据。受保护的账号、私密微博以及任何需要登录才能查看的内容都无法访问，请求无法完成时不扣积分。API 从不以用户身份登录。
用户时间线会返回全部历史博文吗？
+
用户博文和用户原创博文接口每次返回一页近期博文，并支持页码和 since_id 游标，可以逐页向前翻，而不是一次性返回全部存档。需要深度历史数据时请分页；只看最新动态和互动数据时，一次调用就够了。
博文评论会包含所有回复吗？
+
博文评论接口返回一级评论，附每位评论者的完整主页资料，以及评论的点赞数、回复数和楼层号。嵌套回复由单独的子评论接口返回，两者都通过 max_id 游标分页。组合使用即可还原完整评论串；只想看最受关注的反馈时，单独调用评论接口即可。
哪些团队适合使用微博 API？
+
需要微博结构化 JSON 数据、又不想自己开发和维护数据采集程序的团队：做舆情和传播研究的研究人员、管理达人的 MCN 机构、做品牌监测的品牌方，以及需要稳定数据源的数据团队。
支持哪些编程语言和工具？
+
提供官方 Python SDK（pip install scavio）和 JavaScript / TypeScript SDK（npm i scavio）、面向 AI 智能体的远程 MCP 服务器（mcp.scavio.dev），以及 n8n 社区节点。任何语言都可以用 HTTP 客户端直接调用 REST 接口。
使用微博数据合法吗？
+
Scavio 只返回公开可获取的数据，不访问私密内容，也不以用户身份登录。数据的使用方式由您负责，包括遵守微博的服务条款，以及涉及个人信息时遵守 GDPR、中国《个人信息保护法》等隐私法规。具体使用场景请咨询您自己的法律顾问。