Parameters
| Param | Required | Value |
|---|---|---|
platform | no | defaults to douyin (currently the only supported platform) |
limit | no | rows to return, default 20 |
Response
items[]: rank, title, hot_value.
Two easy misreadings
- Sort by
rank, nothot_value: the top slot sometimes comes back with heat 0 because upstream withholds it. That is not a failed call. - The list moves minute to minute: aggregate over time windows instead of treating one snapshot as a conclusion.
Copy and run
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 (stdlib, no dependencies)
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",
)
for t in json.load(urllib.request.urlopen(req, timeout=60))["items"]:
print(t["rank"], t["title"], t["hot_value"])
Real response sample
Taken from a real production call; truncated, image/signed URLs removed.
{
"ok": true,
"platform": "douyin",
"tool": "get_trending",
"count": 2,
"items": [
{"rank": 1, "title": "(top slot title redacted; news items do not belong on a product page)", "hot_value": 0},
{"rank": 2, "title": "\u5728\u7a3b\u57ce\u4e9a\u4e01\u770b\u4e00\u573a\u79cb\u65e5\u7ae5\u8bdd", "hot_value": 11380469}
]
}FAQ
Is historical trending available?
Live snapshot only. Store hourly yourself if you need trends.
Why is the first heat value 0?
Upstream withholds it for that slot; ranking still comes from
rank.Can I filter by category?
The list is global; filter locally on
title.Do you support Weibo or Xiaohongshu trending?
Douyin only at the moment; other platforms are demand-driven.
Related
One key, six platforms
Same schema, same MCP endpoint, one parameter to switch platforms. Sign-up credit included, failed calls are free.
See pricing Try it first