Posts & videosDouyinVideo Mix Item · List
Douyin mix videos
Read one page of currently public videos from a Douyin collection.
POST
/v1/douyin/mixes/videosChinese name: 抖音合集视频 · 合集作品 · 列表 按合集 ID 分页读取当前公开作品和公开计数。douyin.mixes.videos@v1
Price per call
¥0.02/ call
Complete and confirmed empty results are charged; partial results and failures are not.
Checking live statusTry it
This API is coming soon
We are running launch checks. Once live, you can try it right here at the price shown above; nothing is charged before then. You can already read the parameters and response example.
Available now on the same platform
- Douyin video detail
- Douyin mix detail
- Douyin batch video detail
- Douyin related videos
- Douyin music detail
- Douyin videos by music
- Douyin hashtag detail
- Douyin hashtag videos
- Douyin video search
- Douyin video comments
- Douyin comment replies
- Douyin user profile
- Douyin user videos
- Douyin user search
- Douyin hot search
- Douyin rising trends
- Douyin low-follower viral ranking
- Douyin high-completion ranking
- Douyin general search
- Douyin high-like-rate ranking
- Douyin high-follower-conversion ranking
- Douyin similar creators
- Douyin creator engagement and follower trends
- Douyin Xingtu creator search
- Douyin topic ranking
- Douyin hot search terms
- Douyin Xingtu creator batch info
- Douyin Xingtu creator audience
- Douyin Xingtu creator video performance
Sign in and run one real call. The result and charge appear right here.
Security check
Loading the security check…
Checking live execution status…
Execution result
// Result
Request parameters
mix_idstringrequiredpattern: "^\\d{8,32}$"
Example:
"7302011174286002217"cursorstringoptionalminLength: 1
Request JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"mix_id": {
"type": "string",
"pattern": "^\\d{8,32}$"
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"required": [
"mix_id"
],
"additionalProperties": false
}Code samples
Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.
curl -X POST https://api.dataxapi.com/v1/douyin/mixes/videos \
-H "Authorization: Bearer $DATAXAPI_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"mix_id":"7302011174286002217"}'import { ExactApiClient } from "@dataxapi/sdk";
const client = new ExactApiClient({
baseUrl: "https://api.dataxapi.com",
apiKey: process.env.DATAXAPI_API_KEY,
});
const result = await client.call("douyin_mixes_videos_v1", {
"mix_id": "7302011174286002217"
});
console.log(result.data);import os
from dataxapi import ExactApiClient
client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])
result = client.call("douyin_mixes_videos_v1", {
"mix_id": "7302011174286002217",
})
print(result["data"])[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"Response example
200 · application/json
{
"code": 200,
"request_id": "req_example_douyin_batch_3",
"message": "success",
"data": {
"items": [
{
"id": "7677044917696469382",
"caption": "Public collection episode",
"created_at": "2026-08-27T00:00:00.000Z",
"duration_seconds": 19.412,
"cover_url": "https://ci.douyin.com/episode-cover",
"author": {
"id": "creator-douyin-01",
"sec_uid": "sec_creator_douyin_01",
"name": "Public creator",
"avatar_url": "https://ci.douyin.com/mix-avatar"
},
"metrics": {
"plays": 98765,
"likes": 4321,
"comments": 321,
"collects": 222,
"shares": 111
}
}
]
},
"page": {
"next_cursor": "cursor_example"
},
"warnings": [],
"meta": {
"result_status": "complete",
"balance_after": "0.98",
"listing_id": "douyin.mixes.videos",
"version": "v1",
"catalog_release_id": "catalog-production-2026-09-19.b069be57",
"price_book_version": "pricebook-production-2026-09-19.4487e352",
"charged_amount": "0.02",
"currency": "CNY"
}
}Response fields
codenumber- const: 200
request_idstringmessagestring- const: "success"
dataobjectpageobjectwarningsarraymetaobject
Response JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"code": {
"type": "number",
"const": 200
},
"request_id": {
"type": "string"
},
"message": {
"type": "string",
"const": "success"
},
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duration_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"cover_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"author": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"sec_uid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"sec_uid",
"name",
"avatar_url"
],
"additionalProperties": false
},
"metrics": {
"type": "object",
"properties": {
"plays": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"likes": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"collects": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"shares": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"plays",
"likes",
"comments",
"collects",
"shares"
],
"additionalProperties": false
}
},
"required": [
"id",
"caption",
"created_at",
"duration_seconds",
"cover_url",
"author",
"metrics"
],
"additionalProperties": false
}
}
},
"required": [
"items"
],
"additionalProperties": false
},
"page": {
"type": "object",
"properties": {
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"next_cursor"
],
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"meta": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"const": "douyin.mixes.videos"
},
"version": {
"type": "string",
"const": "v1"
},
"catalog_release_id": {
"type": "string",
"minLength": 1
},
"price_book_version": {
"type": "string",
"minLength": 1
},
"result_status": {
"type": "string",
"enum": [
"complete",
"empty",
"partial"
]
},
"charged_amount": {
"type": "string"
},
"balance_after": {
"type": "string"
},
"currency": {
"type": "string",
"const": "CNY"
}
},
"required": [
"listing_id",
"version",
"catalog_release_id",
"price_book_version",
"result_status",
"charged_amount",
"balance_after",
"currency"
],
"additionalProperties": false
}
},
"required": [
"code",
"request_id",
"message",
"data",
"page",
"warnings",
"meta"
],
"additionalProperties": false
}Usage notes
Good for
- Use it to inventory visible episodes for a known public mix ID.
Not for
- Do not use it for mix metadata, paid episodes, Cookies, or archives.
Known limitations
- Each request asks for at most 20 videos.
- Only the returned DataXAPI cursor can continue the query.
- Deleted, paid, or unavailable videos are absent.
Billing
¥0.02 per call. Complete and confirmed empty results are charged; partial results and failures are not.
See all pricing →