douyin/billboard/hot-total-video-list
Get the video list. This capability focuses on douyin (douyin billboard) workflows centered on fetch video hot list.
Input
Time window, 1 by hour 2 by day
Search keyword to filter the billboard, empty for all
Page number
Number of items per page
List category, 1001 Video total list 1002 Low fan explosion 1003 High completion rate 1004 High fan growth rate 1005 High like rate
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-video-list01
Input Schema
6 parameters · 0 required · 6 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number · Default: 1 |
tags | object[] | Optional | Sub-level vertical category tag, empty for all, multiple tags need to be passed in |
keyword | string | Optional | Search keyword to filter the billboard, empty for all · Default: "" |
sub_type | integer | Optional | List category, 1001 Video total list 1002 Low fan explosion 1003 High completion rate 1004 High fan growth rate 1005 High like rate · Default: 1001 |
page_size | integer | Optional | Number of items per page · Default: 10 |
date_window | integer | Optional | Time window, 1 by hour 2 by day · Default: 24 |
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-video-list",
"page": 1,
"keyword": "",
"sub_type": 1001,
"page_size": 10,
"date_window": 24,
"prompt": "a beautiful sunset over mountains"
}'API README
Fetch video hot list
Get the video list. This capability focuses on douyin (douyin billboard) workflows centered on fetch video hot list. It is suitable for douyin workflows.
Capability
Get the video list. This capability focuses on douyin (douyin billboard) workflows centered on fetch video hot list. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Build media monitoring, content intelligence, and publishing-support workflows.
- Create repeatable integrations that pass structured results to downstream business systems.
- Support scheduled jobs, internal tools, and agent workflows with structured results.

