参数
| 参数 | 必填 | 取值 |
|---|---|---|
platform | 否 | 默认 douyin(当前仅支持抖音) |
limit | 否 | 返回条数,默认 20 |
返回什么
items[]:rank(排名)、title(热搜词)、hot_value(热度值)。
两处容易被误读
- 排序看
rank,不要看hot_value:榜单首位这类重要位置有时上游不给热度值,会返回 0(下面样例第一条就是),这不是抓失败。 - 榜单分钟级变化:做定时任务别把结果当长期结论,按时间段聚合更有意义。
复制即可运行
cURL
curl -s https://lucydomi.com/mcp/v1/get_trending \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"platform": "douyin", "limit": 20}'Python(标准库,无需安装依赖)
import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/get_trending",
data=json.dumps({"platform": "douyin", "limit": 20}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for t in data["items"]:
print(t["rank"], t["title"], t["hot_value"])
真实返回样例
下面这段来自线上真实调用,已截断并去掉图片/签名类字段。
{
"ok": true,
"platform": "douyin",
"tool": "get_trending",
"count": 2,
"items": [
{"rank": 1, "title": "(榜首标题已脱敏;热点类内容不适合放在产品页)", "hot_value": 0},
{"rank": 2, "title": "在稻城亚丁看一场秋日童话", "hot_value": 11380469}
]
}常见问题
能拿历史热搜吗?
当前版本只返回实时榜单;要历史趋势请自己按小时落库累计。
为什么第一条热度是 0?
上游对该位置不给热度值,返回 0 属正常,排序以
rank 为准。能按品类过滤热搜吗?
接口返回整榜,品类筛选请本地按关键词匹配
title。支持微博或小红书热搜吗?
当前仅抖音;需要其他平台可以提需求,排期看用量。