# Douyin video list

Get all published items within the specified time range. Needs start time and end time. Served by TikHub.

Purpose:
- Get all published items within the specified time range
- Support pagination query, maximum 100 items per request
- Data update description:
  - **Views, likes, comments, shares, favorites update in real-time**
  - **Other metrics update hourly**
- **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)
- start_time: Start timestamp in milliseconds (required)
- end_time: End timestamp in milliseconds (required)
- count: Number of items per page, default 10, max 100 (optional)
- order_by: Sort method, supports 26 types (optional, default 1)
- fields: Fields to return, default "metrics,review,visibility" (optional)
  - metrics: Traffic metrics (views, likes, comments, shares, favorites, etc.)
  - review: Review status
  - visibility: Visibility status
- need_cooperation: Need cooperation info, default true (optional)
- need_long_article: Include long articles, default true (optional)
- cursor: Pagination cursor, don't pass for first request, use returned cursor for pagination (optional)

Sort Options (order_by):

| Value | Sort Field | Direction | Update Freq | Description |
|-------|-----------|-----------|-------------|-------------|
| 1 | Publish Time | Desc ↓ | - | Default, newest first |
| 2 | Publish Time | Asc ↑ | - | Oldest first |
| 3 | Views | Desc ↓ | Real-time | Video views count |
| 4 | Views | Asc ↑ | Real-time | Least views first |
| 5 | Likes | 

- Tool ID: `tikhub/douyin-creator-v2-fetch-item-list`
- Name in the catalog: Douyin, Fetch item list
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Douyin creator analytics](/tools/douyin/creator-analytics.md)
- Price: $0.001 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.001
}
```

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.001; 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": {
    "count": {
      "type": "integer",
      "title": "Count",
      "description": "每页数量/Count per page (最多100条)",
      "default": 10
    },
    "order_by": {
      "type": "integer",
      "title": "Order By",
      "description": "排序方式/Order by (1-26): 1=发布时间↓(新到旧), 2=发布时间↑(旧到新), 3=播放量↓, 4=播放量↑, 5=点赞量↓, 6=点赞量↑, 7=评论量↓, 8=评论量↑, 9=分享量↓, 10=分享量↑, 11=收藏量↓, 12=收藏量↑, 13=2s跳出率↓, 14=2s跳出率↑, 15=5s完播率↓, 16=5s完播率↑, 17=完播率↓, 18=完播率↑, 19=封面点击率↓, 20=封面点击率↑, 21=平均播放时长↓, 22=平均播放时长↑, 23=主页访问量↓, 24=主页访问量↑, 25=粉丝增量↓, 26=粉丝增量↑",
      "default": 1
    },
    "fields": {
      "type": "string",
      "title": "Fields",
      "description": "需要返回的字段/Fields to return",
      "default": "metrics,review,visibility"
    },
    "need_cooperation": {
      "type": "boolean",
      "title": "Need Cooperation",
      "description": "是否需要合作信息/Need cooperation info",
      "default": true
    },
    "start_time": {
      "type": "integer",
      "title": "Start Time",
      "description": "开始时间戳(毫秒)/Start time timestamp (milliseconds)"
    },
    "end_time": {
      "type": "integer",
      "title": "End Time",
      "description": "结束时间戳(毫秒)/End time timestamp (milliseconds)"
    },
    "need_long_article": {
      "type": "boolean",
      "title": "Need Long Article",
      "description": "是否包含长图文/Include long articles",
      "default": true
    },
    "cursor": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "description": "分页游标/Pagination cursor (可选)"
    }
  },
  "required": [
    "start_time",
    "end_time"
  ],
  "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",
  "input": {
    "count": 10,
    "order_by": 1,
    "fields": "metrics,review,visibility",
    "need_cooperation": true,
    "start_time": 1758988800000,
    "end_time": 1760198399000,
    "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_api_v1_douyin_creator_v2_fetch_item_list_post)

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

---

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