douyin/billboard/hot-total-list
Get the total hot list. This capability focuses on douyin (douyin billboard) workflows centered on fetch total hot list.
Input
Snapshot end time format yyyyMMdd
Hot search term
Page number
Number of items per page
Hot category tag, get from hot list category, multiple categories separated by commas, empty for all
Snapshot time format yyyyMMddHHmmss
Snapshot start time format yyyyMMdd
Snapshot type snapshot view by time range view by time range.
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
douyin/billboard/hot-total-list01
Input Schema
8 parameters · 3 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Required | Page number |
type | string | Required | Snapshot type snapshot view by time range view by time range. |
page_size | integer | Required | Number of items per page |
keyword | string | Optional | Hot search term |
end_date | string | Optional | Snapshot end time format yyyyMMdd |
start_date | string | Optional | Snapshot start time format yyyyMMdd |
sentence_tag | string | Optional | Hot category tag, get from hot list category, multiple categories separated by commas, empty for all |
snapshot_time | string | Optional | Snapshot time format yyyyMMddHHmmss |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "douyin/billboard/hot-total-list",
"prompt": "a beautiful sunset over mountains"
}'API README
Fetch total hot list
Get the total hot list. This capability focuses on douyin (douyin billboard) workflows centered on fetch total hot list. It is suitable for douyin workflows.
Capability
Get the total hot list. This capability focuses on douyin (douyin billboard) workflows centered on fetch total hot list. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Connect structured data to dashboards, agents, internal tools, and automated workflows.
- Create repeatable integrations that pass structured results to downstream business systems.
- Support scheduled jobs, internal tools, and agent workflows with structured results.

