微博热搜榜 API
取微博当前的热搜榜,50 个词,带名次和热度。每次约 50 条,最多 51 条;$0.0020 一次。出错和超时不收费;空结果收 $0.0020。
试一次
改一个值,右边的请求跟着变。登录后运行,用你自己的余额。 这个接口新用户可免费试用 50 次。
以前用的是 POST /v1/weibo/trends/hot-search?已经换成这个地址。 旧接口改了什么
curl "https://api.dataxapi.com/v1/weibo/trends/list" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
{
"code": "ok",
"request_id": "f9f2f03d-c0cc-4aa8-8bad-4c000011ecb1",
"data": {
"items": [
{ "name": "周末露营怎么玩", "rank": 1, "heat": 200636 },
// … 另有 49 条
]
},
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 50
},
"warnings": [],
"meta": {
"capability": "weibo.trends.list",
"result_status": "complete",
"fetched_at": "2026-10-12T18:58:04.000Z",
"cached": false,
"replayed": false,
"unavailable": { "id": "platform" },
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}取自 2026-10-12 18:58 UTC 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。
返回大小:标准档 3.7 KB(精简 3.7 KB,完整 3.7 KB)。
{
"code": "ok",
"request_id": "830cd307-f0ef-4ca5-92bb-2878d7b1cd9a",
"data": { "items": [] },
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 0
},
"warnings": [],
"meta": {
"capability": "weibo.trends.list",
"result_status": "empty",
"fetched_at": "2026-10-12T18:58:04.000Z",
"cached": false,
"replayed": false,
"unavailable": { "id": "platform" },
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}取自 2026-10-12 18:58 UTC 的录制,为演示这种情况人工改过。请求号和余额是示意。
返回大小:标准档 415 B(精简 415 B,完整 415 B)。
curl "https://api.dataxapi.com/v1/weibo/trends/list" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.weibo.trends.list() print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.weibo.trends.list();
console.log(result.data.items);dataxapi call weibo.trends.list
{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}把这段加进你的 MCP 客户端,然后让你的 AI 调用 weibo.trends.list。
参数
选哪个榜:现在只有热搜榜。取值:hot_search(默认)。示例:hot_search。
返回档位。三档价格相同。取值:compact、standard(默认)、full。
只要这些字段。按路径写,例如 author.name。
已知限制
- 每页约 50 条,最多 51 条。每页条数由平台决定,不收
limit。 - 一次给全,不发游标。
- 结果来自共享快照,每 10 分钟更新一次;
meta.cached会标明,meta.fetched_at是取数时间。 - 这个对象有 1 个字段这个接口给不了
返回字段
data.items 是热点对象的列表。稳定:字段只增不改。
平台给这个热点的编号
热点的名称
榜上的名次,从 1 起;置顶条没有名次
平台给的热度值
这一条里哪些数是约数或下限;都是准确值时不出现
字段的路径,如 metrics.views
展开全部 7 个字段 →
约数,还是下限approximatelower_bound
每条数据的典型体积:compact 68 B、standard 68 B、full 68 B(按 2026-10-12 18:58 UTC 录下的那次返回量的)。
这个接口给不了的
id平台没有什么时候收费
X-Max-Price 可以设自己的上限,超过就不执行)价格读取于 2026-10-21 10:10 UTC,按价目版本 2,2026-10-17 11:00 UTC 起生效;在 Playground 里运行前会再读一次当前价格。
常见报错
这个接口会返回的错误码;所有接口共有的见完整列表。
invalid_params参数不合法能否重试:改了再试未扣费insufficient_balance余额不足能否重试:改了再试未扣费upstream_failed数据来源出错能否重试:能未扣费timeout没有在时限内取到数据,可以用同一个幂等键重试能否重试:能未扣费常见问题
微博热搜榜 API 多少钱?
$0.0020 一次。单次最高扣费 $0.0020。
什么情况下不收费?
出错和超时不收费;空结果收 $0.0020。
一次返回多少条?怎么翻页?
每页约 50 条,最多 51 条。每页条数由平台决定,不收 limit。一次给全,不发游标。
同一件事的其他平台
微博的全部 10 个接口
在你的 AI 里用它
复制这段提示词
你的 API Key 已经写在里面,不用再配置什么。
还没有账户?注册只要一个邮箱,不用绑卡,失败的调用不收费。
贴给你的 agent
它会去读提示词指向的那一页,自己接好。
现在问点什么
用下面任意一句,或者用自己的话问。
想自己手动配置?
dataxapi setup给这台电脑上的 AI 代理(Claude Code、Codex、Cursor)装好 DataXAPI 的 MCP 服务和基础技能。Key 从环境变量 DATAXAPI_API_KEY 读,不写进任何文件。MCP 服务地址:https://api.dataxapi.com/mcp。你的客户端要填的配置在本页请求示例的“MCP”页签里;接好后让你的 AI 调用 weibo.trends.list。其他客户端 →展开全文
使用 DataXAPI 的接口 weibo.trends.list(微博热搜榜)。取微博当前的热搜榜,50 个词,带名次和热度。 用 GET 请求 https://api.dataxapi.com/v1/weibo/trends/list,带请求头 "Authorization: Bearer $DATAXAPI_API_KEY"。Key 从环境变量 DATAXAPI_API_KEY 读,不要写进代码。 参数: - board:选哪个榜:现在只有热搜榜。取值:hot_search(默认)。示例:hot_search。 - view:返回档位。三档价格相同。取值:compact、standard(默认)、full。 - fields:只要这些字段。按路径写,例如 author.name。 价格:$0.0020 一次。出错和超时不收费;空结果收 $0.0020。 返回 JSON:data.items 是热点;meta.billing.amount 是这次调用的扣费。 示例: curl "https://api.dataxapi.com/v1/weibo/trends/list" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" 完整说明(Markdown):https://dataxapi.com/zh/apis/weibo/trends/list.md
名称和编号
- 英文名
- Weibo hot search board API
- 接口编号
weibo.trends.list- 地址
GET /v1/weibo/trends/list
一把 Key,开始用。
21 个平台 207 个接口,一次 $0.0003 起。出错和超时不收费。