微博 API
用 REST 接口读取微博的微博、评论、用户资料、关键词搜索和热搜榜：共 7 个已上线接口，同一个 API Key，同一个 JSON 外层。下面是完整的接口列表和一个真实的请求与返回示例。
新账号有 50 次试用调用，之后按成功调用从预充值余额扣费，详见 定价。
微博 API 的 7 个接口
每个接口的参数、返回字段和代码示例见 API 参考。
- 微博详情
GET /v1/raw/weibo/post单条微博：全文（长微博也是全文）、作者、点赞/评论/转发数、阅读数和视频播放量（微博展示时）、话题、图片、视频时长、发布时间、被转发的原微博和链接。 传 mid 或链接里的 mblogid 均可。微博不存在或已删除时返回 404，不计费。必填参数：post_id - 微博评论
GET /v1/raw/weibo/comments微博的一级评论（按热度），按游标翻页，每页最多 20 条：评论内容、点赞数、回复数、IP 属地、时间、是否被博主赞过和评论者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.weibo.comment_replies 获取。没有评论或微博不存在时返回空结果，不计费。必填参数：post_id - 微博评论回复
GET /v1/raw/weibo/comment_replies某条评论下的回复（楼中楼），按游标翻页，每页最多 20 条：回复内容、点赞数、IP 属地、时间、回复对象和回复者。 把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止；偶尔某页会先返回空结果，重试一次即可。没有回复时返回空结果，不计费。必填参数：comment_id - 微博用户资料
GET /v1/raw/weibo/user微博用户主页资料：粉丝、关注、微博数、累计获赞、认证信息、简介、性别、所在地、个性域名和头像。传 uid 或个性域名（weibo.com/<域名>）其中一个。 用户不存在时返回 404，不计费。 - 微博用户发布列表
GET /v1/raw/weibo/user_posts一个用户发布的微博，置顶在前，其余从新到旧，每页约 20 条，记录与微博详情相同（同一 id）；长微博只有开头（extra.truncated 为 true，全文用 raw.weibo.post 获取）。 按 page 翻页，has_more 为 false 时停止。没有微博时返回空结果，用户不存在时返回 404，均不计费。必填参数：uid - 微博搜索
GET /v1/raw/weibo/search按关键词搜索微博，可限定发布日期范围（北京时间，按天），可只看热门、原创、认证用户、媒体或观点，可只看含图片、视频、音乐或链接的微博；记录与微博详情相同（同一 id），正文可能被截断（extra.truncated），互动数不提供。 每页条数不固定（最多约 20 条），按 page 翻页，最多 50 页，返回空结果时停止。没有结果时返回空结果，不计费。必填参数：keyword - 微博热搜榜
GET /v1/raw/weibo/hot_search微博实时热搜榜，按排名：热搜词、热度、标签（新、热、沸、爆等）、分类、是否话题和搜索链接，以及置顶在榜首之上的话题（pinned）。广告位不返回。 无需参数，约每分钟更新。
请求与返回示例
微博搜索（GET /v1/raw/weibo/search）。示例取自接口目录，不是实时数据；完整返回还带 request_id 和 meta。
curl 'https://api.qovia.ai/v1/raw/weibo/search?keyword=%E9%95%BF%E5%BE%81&start_date=2026-10-20&end_date=2026-10-21' \ -H "Authorization: Bearer $QOVIA_KEY"
{
"data": {
"items": [
{
"id": "soc_wei_66be530dfcd9",
"src": "social",
"platform": "weibo",
"lang": "zh-CN",
"text": "【#活动散场后男子吹响冲锋号全场沸腾#】近日，天津一场长征胜利90周年纪念活动散场后，一名男子吹响冲锋号，瞬间全场沸腾。该男子接受中新网采访时表示，当时散场后大家说再吹一个，于是就贴合主题吹了冲锋号。中国新闻网的微博视频（中国新闻网）",
"author": {
"uid_hash": "f879ebcea33e",
"followers": null,
"nickname": "工人日报",
"uid": "3840768703"
},
"metrics": {
"likes": null,
"comments": null,
"shares": null
},
"extra": {
"source_id": "5356593191060572",
"mblogid": "RnKfl4rU0",
"published_at": "2026-10-21T23:00:00+08:00",
"content_type": "video",
"topic": "#活动散场后男子吹响冲锋号全场沸腾",
"topics": [
"活动散场后男子吹响冲锋号全场沸腾"
],
"images": [],
"cover_url": null,
"video_dur_s": null,
"ip_location": null,
"truncated": false,
"repost_of": null,
"url": "https://weibo.com/3840768703/RnKfl4rU0"
},
"prov": {
"hash": "0xdc59f6580c0f1192",
"ts": "2026-10-21T23:50:00+08:00",
"source": "live"
}
},
{
"id": "soc_wei_efafe027096e",
"src": "social",
"platform": "weibo",
"lang": "zh-CN",
"text": "#晚安，广西！#【#周深献唱纪念红军长征胜利90周年MV#】九十年长风不息，烽烟虽远，星火滚烫。@卡布叻_周深倾情演唱的《万里长风》，以歌声回望来路，循先辈足迹，奔赴属于我们的新征程。#跨越90年的回信#（来源：央视新闻）央视新闻的微博视频",
"author": {
"uid_hash": "8a692ede06c2",
"followers": null,
"nickname": "广西新闻网",
"uid": "1986954045"
},
"metrics": {
"likes": null,
"comments": null,
"shares": null
},
"extra": {
"source_id": "5356593190540232",
"mblogid": "RnKfl2gxq",
"published_at": "2026-10-21T23:00:00+08:00",
"content_type": "video",
"topic": "#晚安，广西！",
"topics": [
"晚安，广西！",
"周深献唱纪念红军长征胜利90周年MV",
"跨越90年的回信"
],
"images": [],
"cover_url": null,
"video_dur_s": null,
"ip_location": null,
"truncated": false,
"repost_of": null,
"url": "https://weibo.com/1986954045/RnKfl2gxq"
},
"prov": {
"hash": "0xd5cc0da71c4fbd32",
"ts": "2026-10-21T23:50:00+08:00",
"source": "live"
}
}
],
"page": 1,
"has_more": true,
"prov": {
"hash": "0x0454d79596c740cd",
"ts": "2026-10-21T23:50:00+08:00",
"source": "live"
}
}
}让 AI 工具直接用微博数据
Qovia 同时是一个 MCP 服务。在 Claude Code 里运行下面这条命令，查找和查看接口不需要 Key；调用接口时按 MCP 文档 配置你的 API Key。Cursor 和 VS Code 的配置也在那里。
claude mcp add --transport http qovia https://api.qovia.ai/mcp常见问题
怎么调用微博 API？
向 https://api.qovia.ai 发 GET 请求，例如 /v1/raw/weibo/…，在请求头里带上 Authorization: Bearer 加你的 API Key。成功时返回 HTTP 200 和 request_id、data、meta 三个字段。本页列出了全部 7 个接口，每个接口的参数见 API 参考。
微博有官方开放的数据 API 吗？
微博开放平台的接口要先创建应用、经用户授权才能调用，按关键词搜索全站微博、拿任意微博的评论这类公开数据，普通开发者一般拿不到。Qovia 把微博的公开数据做成了统一接口，拿 API Key 就能调用。
能拿到微博的哪些数据？
单条微博（全文、作者、点赞/评论/转发数，微博展示时还有阅读数和视频播放量，以及话题、图片、发布时间和 IP 属地）、评论和评论回复、用户资料和发布列表、关键词搜索（可限定日期范围，只看热门、原创或认证用户等），以及微博热搜榜。
微博搜索能拿多少条？
每页最多约 20 条，按页翻，最多 50 页。搜索结果里的正文可能被截断，也不带互动数；需要全文和点赞、评论、转发数时，用微博 ID 调微博详情接口。
需要提供微博账号或 cookie 吗？
不需要。你只需要一个 Qovia 的 API Key，不用自己维护账号、cookie、代理或签名算法。
怎么计费？
预充值，按次计费，只对返回了数据的成功调用扣费；空结果、报错和超时都不扣费，每次返回里都写着这次扣了多少（meta.charged_usd）。每个接口的单价见 API 参考。
能接到 Claude、Cursor 这类 AI 工具里吗？
可以。Qovia 同时是一个 MCP Server（https://api.qovia.ai/mcp），在 Claude Code、Cursor、VS Code 里配置好 API Key 后，就能直接让 AI 找接口、拉数据、做总结。
使用这些数据要注意什么？
Qovia 提供的是数据接口服务，不拥有也不转售底层内容。拿到的数据请按适用法律和微博的平台规则使用，详见服务条款。