Home · Resources · Douyin Trending API

Douyin Trending API

The cheapest way to pick a topic: see what the platform is pushing right now, as structured fields instead of a screenshot.

Parameters

ParamRequiredValue
platformnodefaults to douyin (currently the only supported platform)
limitnorows to return, default 20

Response

items[]: rank, title, hot_value.

Two easy misreadings

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

Keyword searchDouyin commentsDouyin dataQuick start

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