Parameter
| Parameter | Required | Value |
|---|---|---|
| platform | Yes (currently douyin only) | Douyin trending only for now; other platforms return an explicit unsupported error |
| limit | No | Number of items; defaults to the platform's own count |
Using the trending list without wasting it
The list alone means little; the real work is the second step: take ranks 3–10 (not rank 1 — the top entry is usually a big event you cannot ride) and run them through search_posts for one round, and see what shape the content takes and what the comments are asking.
Response fields
Each item carries rank, title/topic, hot value and a link. Hot value is the platform's own metric and is not comparable across platforms.
Mainland platform note
Douyin sits in the mainland platform group. New accounts can try it 5 times for free, then need $30 in cumulative top-ups on the account to unlock it; overseas platforms work as soon as you register.
Copy and run
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": 10}'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": 10}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for it in data["items"]:
print(it.get("url"), it.get("text", "")[:60])Real response sample
A real production response below — truncated to one item, billing fields removed.
{ "ok": true, "platform": "douyin", "tool": "get_trending", "count": 5, "items": [ { "platform": "douyin", "rank": 1, "title": "渡船之上 信仰如磐", "hot_value": 0 }, { "platform": "douyin", "rank": 2, "title": "中超成都蓉城0:1大连英博", "hot_value": 11166308 }, { "platform": "douyin", "rank": 3, "title": "第31号台风烟花已生成", "hot_value": 11097428 }, { "platform": "douyin", "rank": 4, "title": "各类救援车辆星夜驰援西藏地震灾区", "hot_value": 11087395 }, { "platform": "douyin", "rank": 5, "title": "金正恩访问丹东", "hot_value": 11049079 } ] }FAQ
Do other platforms have a trending list?
How often does the trending list update?
Can I filter by industry?
Related
One key, six platforms
Same fields, same MCP endpoint — switching platform means changing one parameter. New accounts get $0.2 in credit.
View pricing Try it once