API reference · Douyin
douyin/creator-v2/item-list
Integrate this model through SandBase's unified API, with production-ready schemas and examples.
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
douyin/creator-v2/item-list01
Input Schema
9 parameters · 3 required · 6 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
cookie | string | Required | 用户Cookie/User Cookie |
end_time | integer | Required | 结束时间戳(毫秒)/End time timestamp (milliseconds) |
start_time | integer | Required | 开始时间戳(毫秒)/Start time timestamp (milliseconds) |
count | integer | Optional | 每页数量/Count per page (最多100条) · Default: 10 |
cursor | union | Optional | 分页游标/Pagination cursor (可选) |
fields | string | Optional | 需要返回的字段/Fields to return · Default: "metrics,review,visibility" |
order_by | integer | Optional | 排序方式/Order by (1-26): 1=发布时间↓(新到旧), 2=发布时间↑(旧到新), 3=播放量↓, 4=播放量↑, 5=点赞量↓, 6=点赞量↑, 7=评论量↓, 8=评论量↑, 9=分享量↓, 10=分享量↑, 11=收藏量↓, 12=收藏量↑, 13=2s跳出率↓, 14=2s跳出率↑, 15=5s完播率↓, 16=5s完播率↑, 17=完播率↓, 18=完播率↑, 19=封面点击率↓, 20=封面点击率↑, 21=平均播放时长↓, 22=平均播放时长↑, 23=主页访问量↓, 24=主页访问量↑, 25=粉丝增量↓, 26=粉丝增量↑ · Default: 1 |
need_cooperation | boolean | Optional | 是否需要合作信息/Need cooperation info · Default: true |
need_long_article | boolean | Optional | 是否包含长图文/Include long articles · Default: true |
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/creator-v2/item-list",
"count": 10,
"fields": "metrics,review,visibility",
"order_by": 1,
"need_cooperation": true,
"need_long_article": true,
"prompt": "a beautiful sunset over mountains"
}'