# Download Douyin video list

Export detailed data of top 1000 items within the specified time range. Needs min cursor and max cursor. Served by TikHub.

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
- Filename: 作品列表导出.xlsx (Item List Export.xlsx)
- 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

- Tool ID: `tikhub/douyin-creator-v2-fetch-item-list-download`
- Name in the catalog: Douyin, Download item list
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Douyin creator analytics](/tools/douyin/creator-analytics.md)
- Price: $0.01 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.01
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.01; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "min_cursor": {
      "type": "integer",
      "title": "Min Cursor",
      "description": "最小游标(开始时间戳,毫秒)/Min cursor (start timestamp in milliseconds)"
    },
    "max_cursor": {
      "type": "integer",
      "title": "Max Cursor",
      "description": "最大游标(结束时间戳,毫秒)/Max cursor (end timestamp in milliseconds)"
    },
    "type_filters": {
      "items": {
        "type": "integer"
      },
      "type": "array",
      "title": "Type Filters",
      "description": "体裁类型过滤/Type filters: 1=1min以内视频, 2=1-3min视频, 3=3-5min视频, 4=5min+视频, 5=图文, 8=长图文",
      "default": [
        1,
        2,
        3,
        4,
        5,
        8
      ]
    },
    "need_long_article": {
      "type": "boolean",
      "title": "Need Long Article",
      "description": "是否包含长图文/Include long articles",
      "default": true
    }
  },
  "required": [
    "min_cursor",
    "max_cursor"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/douyin-creator-v2-fetch-item-list-download",
  "input": {
    "min_cursor": 1752336000000,
    "max_cursor": 1760198399000,
    "type_filters": [
      2,
      3,
      4,
      5,
      1,
      8
    ],
    "need_long_article": true
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/Douyin-Creator-V2-API/fetch_item_list_download_api_v1_douyin_creator_v2_fetch_item_list_download_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/douyin-creator-v2-fetch-item-list-download) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/douyin-creator-v2-fetch-item-list-download) · [Agent index](/llms.txt)