douyin/index/item-query
Search the Douyin Index video library with 4-dimensional filters: category, duration, label type, publish date Results contain basic video info plus core metrics (plays, likes, followers, etc.).
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/rundouyin/index/item-queryInput Schema
5 parameters · 1 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Required | Search keyword (required), e.g. "food" |
date_type | integer | Optional | Publish date filter, default 0=any · Default: 0 |
label_type | integer | Optional | Video type (quality tag), default 0=any · Default: 0 |
category_id | string | Optional | Category ID (string), default "0"=all · Default: "0" |
duration_type | integer | Optional | Duration filter, default 0=any · Default: 0 |
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 |
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/index/item-query",
"date_type": 0,
"label_type": 0,
"category_id": "0",
"duration_type": 0,
"prompt": "a beautiful sunset over mountains"
}'API README
Video search results
Search the Douyin Index video library with 4-dimensional filters: category, duration, label type, publish date Results contain basic video info plus core metrics (plays, likes, followers, etc.). It is suitable for douyin workflows.
Capability
Search the Douyin Index video library with 4-dimensional filters: category, duration, label type, publish date Results contain basic video info plus core metrics (plays, likes, followers, etc.). It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Search and discover relevant records for research, monitoring, and product experiences.
- Build media monitoring, content intelligence, and publishing-support workflows.
- Create repeatable integrations that pass structured results to downstream business systems.