GET /v1/douyin/creator/fetch_creator_hot_spot_billboard
Get creator hot spot billboard
stable · 2 credits per success
Get Douyin creator hot spot billboard data；billboard_tag: Hot spot tag - multiple tags separated by comma；Available values；- Platform Features: 1004,1000,1002,1003,1001；- Topic Interaction: 20001,20006,20000,20003,20005,20002,20；- Entertainment: 2007,2000,2011,2012,2009,2010,2004,2005,2003,2008,2001,2002,2006；- Society: 4005,4006,4007,4003,4004,4000；- Anime: 13000；- Transportation: 23000；- Parent…
Request parameters
| Name | Type | In | Required | Description | Example |
|---|---|---|---|---|---|
| city_code | string | query | no | 城市代码，当hot_search_type=2时必需 | demo |
| billboard_tag | string | query | no | 热点标签，多个标签用逗号分隔，如'1004,1000,1002' | demo |
| hot_search_type | integer | query | no | 热搜类型: 1=热点总榜, 2=同城热点榜, 3=热点上升榜 | demo |
Response fields
Field dictionary coming soon — the executable panel shows the live shape.
Errors
| code | HTTP | Meaning | Billed |
|---|---|---|---|
| 40001 | 400 | Invalid parameters | no |
| 40102 | 401 | Invalid or revoked API Key | no |
| 40201 | 402 | Insufficient credits | no |
| 40402 | 404 | Resource not found | no |
| 42201 | 422 | Quality gate failed | no |
| 42901 | 429 | Rate limit exceeded | no |
| 50401 | 504 | Upstream timeout | no |
| 50201 | 502 | Upstream error | no |
Billing
Success costs 2 credits. Any failure — including a 200 from upstream that fails the quality gate — costs 0.