douyin/creator-v2/item-list-download

Download item list

Purpose:

• Export detailed data of top 1000 items within the specified time range
• Support filtering export content by genre types
• This API is for batch export, not suitable for real-time queries
• Export tasks are processed asynchronously, need to wait for server to generate file
• This API requires users to provide valid Douyin Creator Platform Cookie
• Use POST method, Cookie is transmitted in request body, more secure

Request Body Parameters:

• cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)
• min_cursor: Min cursor, i.e., start timestamp in milliseconds (required)
• max_cursor: Max cursor, i.e., end timestamp in milliseconds (required)
• type_filters: Genre type filter list, default all [1,2,3,4,5,8] (optional)
  • 1: Videos under 1 minute
  • 2: 1-3 minute videos
  • 3: 3-5 minute videos
  • 4: Videos over 5 minutes
  • 5: Image posts
  • 8: Long image posts
• need_long_article: Include long articles, default true (optional)

Return:

• Directly returns Excel file stream, browser will auto-download
• File Format: Excel (.xlsx)
• Content-Type: application/vnd.ms-excel

Usage Flow:

1. Initiate export request: Submit time range and filter conditions
2. Receive file: API returns Excel file stream directly
3. Auto download: Browser automatically triggers file download
4. Data analysis: Open Excel file for data analysis

Limitations:

• Only supports exporting: Top 1000 items in selected period
• Support filtering by genre types (can select any combination of 1-6 genres)
• Not suitable for real-time queries, designed for batch data analysis

Genre Type Description:

Type	Genre Name	Description	Use Case
1	<1min video	Short video	Fast spread, high engagement
2	1-3min video	Medium-short video	Balance content & duration
3	3-5min video	Medium-long video	Deep content presentation
4	5min+ video	Long video	Professional content, deep analysis
5	Image post	Image post	Picture + text format
8	Long image post	Long image post	Deep image-text content

Export Data Includes:

• Item basic info (ID, title, publish time, etc.)
• Traffic metrics (views, likes, comments, shares, favorites)
• Review status
• Visibility settings
• Other creator-related data

Timestamp Conversion:

• JavaScript: new Date('2025-07-01').getTime() -> 1719763200000
• Python: int(datetime(2025, 7, 1).timestamp() * 1000) -> 1719763200000

How to get Cookie:

1. Login to Douyin Creator Platform (https://creator.douyin.com)
2. Open browser developer tools (F12)
3. Switch to Network tab
4. Refresh page or perform operations
5. Find any request and copy the Cookie header value

[Example]

{
    "cookie": "Your_Cookie_Here",
    "min_cursor": 1752336000000,
    "max_cursor": 1760198399000,
    "type_filters": [1, 2, 3, 4, 5, 8],
    "need_long_article": true
}

{
    "cookie": "Your_Cookie_Here",
    "min_cursor": 1752336000000,
    "max_cursor": 1760198399000,
    "type_filters": [1, 2, 3, 4],
    "need_long_article": false
}

{
    "cookie": "Your_Cookie_Here",
    "min_cursor": 1752336000000,
    "max_cursor": 1760198399000,
    "type_filters": [5, 8],
    "need_long_article": true
}

curl -X POST "https://your-api.com/api/v1/douyin_creator_v2/fetch_item_list_download"       -H "Authorization: Bearer YOUR_TOKEN"       -H "Content-Type: application/json"       -d '{
    "cookie": "Your_Cookie_Here",
    "min_cursor": 1752336000000,
    "max_cursor": 1760198399000,
    "type_filters": [1,2,3,4,5,8]

import requests

response = requests.post(
    "https://your-api.com/api/v1/douyin_creator_v2/fetch_item_list_download",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "cookie": "Your_Cookie_Here",
        "min_cursor": 1752336000000,
        "max_cursor": 1760198399000,
        "type_filters": [1,2,3,4,5,8]
    }
)

    f.write(response.content)

const axios = require('axios');
const fs = require('fs');

axios.post('https://your-api.com/api/v1/douyin_creator_v2/fetch_item_list_download', {
    cookie: 'Your_Cookie_Here',
    min_cursor: 1752336000000,
    max_cursor: 1760198399000,
    type_filters: [1,2,3,4,5,8]
}, {
    headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
    responseType: 'arraybuffer'
}).then(response => {
});

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.