douyin/app-v3/add-video-play-count
Increase the number of plays of the work according to the video ID This interface uses guest Cookie by default.. Each call to a single work increases the number of plays by 1.. After about `1000` calls, Douyin will restr...
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/app-v3/add-video-play-countInput Schema
3 parameters · 2 required · 1 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
item_id | string | Required | Video id, alias aweme_id |
aweme_type | integer | Required | Video type, 0: Video 1: Graphic and text, can be obtained from the single work data interface. |
cookie | string | Optional | Optional, use guest Cookie by default |
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/app-v3/add-video-play-count",
"prompt": "a beautiful sunset over mountains"
}'API README
Increase the number of plays of the work according to the video ID
Increase the number of plays of the work according to the video ID This interface uses guest Cookie by default. Each call to a single work increases the number of plays by 1. After about 1000 calls, Douyin will restrict it. You need to wait for a period of time (such as 2 hours) before continuing to call. This restriction is for the work, not for the interface. When browsing the work without logging in, using different IP browsers or browsing the work in the APP, the number of plays of the work will not increase. The above restrictions are based on test results, and the specific restrictions may vary, for reference only. It is suitable for douyin workflows.
Capability
Increase the number of plays of the work according to the video ID This interface uses guest Cookie by default. Each call to a single work increases the number of plays by 1. After about 1000 calls, Douyin will restrict it. You need to wait for a period of time (such as 2 hours) before continuing to call. This restriction is for the work, not for the interface. When browsing the work without logging in, using different IP browsers or browsing the work in the APP, the number of plays of the work will not increase. The above restrictions are based on test results, and the specific restrictions may vary, for reference only. 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.