Douyin Fetch Creator Item List
## Purpose List published items for the Douyin creator account authenticated by your Cookie within a specified publication time range. Use the results to review item performance, compare engagement, and inspect review and visibility information. ## Inputs Supply a `request_body` object with: - **Required:** `cookie`, a valid Douyin Creator Platform Cookie; `start_time` and `end_time`, integer Unix timestamps in **milliseconds**. - `count`: items per page; default **10**, maximum **100**. - `order_by`: sort option from **1–26**; default **1** (newest first). - `fields`: requested field groups; default `"metrics,review,visibility"`. `metrics` covers traffic and engagement metrics, `review` covers review status, and `visibility` covers visibility status. - `need_cooperation`: request cooperation information; default `true`. - `need_long_article`: include long-form image/text posts; default `true`. - `cursor`: optional integer pagination cursor. Omit it on the first request. ### Sorting For each pair below, the first value sorts descending and the second ascending: | Values | Sort field | |---|---| | 1 / 2 | Publication time (newest / oldest first) | | 3 / 4 | Views | | 5 / 6 | Likes | | 7 / 8 | Comments | | 9 / 10 | Shares | | 11 / 12 | Favorites | | 13 / 14 | Two-second bounce rate | | 15 / 16 | Five-second completion rate | | 17 / 18 | Full completion rate | | 19 / 20 | Cover click-through rate | | 21 / 22 | Average play duration | | 23 / 24 | Profile visits | | 25 / 26 | Follower growth | ## Results and pagination The response contains result data described as `items` (the list of items and requested details), `has_more` (whether more results are available), and `cursor` (the next-page cursor). The result data schema is open-ended; inspect the actual payload for available fields rather than assuming every metric is always present. If `has_more` is `true`, use the returned `cursor` for the next request. Repeat until `has_more` is `false`. One call retrieves one page, not necessarily the entire list. ## Freshness and limits Views, likes, comments, shares, and favorites update in real time. Bounce/completion metrics, cover click-through rate, average play duration, and follower growth update hourly; profile visits update daily. Genre filtering is documented as limited to the first 100 items in the selected period, and this tool exposes no genre-filter parameter. This tool does not perform bulk export. Very broad time ranges may cause timeouts. If authentication fails, check that your Cookie is still valid.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 投稿作品列表请求参数/Item list request parameters | — |
request_body.count | integer | No | 每页数量/Count per page (最多100条) | 10 |
request_body.cookie | string | Yes | 用户Cookie/User Cookie | — |
request_body.cursor | integer | null | No | 分页游标/Pagination cursor (可选) | — |
request_body.fields | string | No | 需要返回的字段/Fields to return | metrics,review,visibility |
request_body.end_time | integer | Yes | 结束时间戳(毫秒)/End time timestamp (milliseconds) | — |
request_body.order_by | integer | No | 排序方式/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=粉丝增量↑ | 1 |
request_body.start_time | integer | Yes | 开始时间戳(毫秒)/Start time timestamp (milliseconds) | — |
request_body.need_cooperation | boolean | No | 是否需要合作信息/Need cooperation info | true |
request_body.need_long_article | boolean | No | 是否包含长图文/Include long articles | true |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_fetch_creator_item_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"cookie": "[REDACTED]",
"count": 100,
"end_time": 1793974139709,
"fields": "metrics,review,visibility",
"order_by": 1,
"start_time": 1759414139709
}
}
}'{
"code": 200,
"data": {
"BaseResp": {
"Extra": {},
"StatusCode": 0,
"StatusMessage": ""
},
"has_more": false,
"items": [
{
"collaborative": false,
"cover": {
"uri": "tos-cn-i-0813/oAj0E3LpAXa1EjCiBAGAIRxz7fVAyEDBAZIfeY",
"url_list": [
"https://p3-sign.douyinpic.com/tos-cn-i-0813/oAj0E3LpAXa1EjCiBAGAIRxz7fVAyEDBAZIfeY~tplv-dy-resize-walign-adapt-aq:540:q75.webp?lk3s=138a59ce&x-expires=1795183200&x-signature=L5tXp67L1zZaX7AsiyJ2mw0YSWY%3D&from=327834062&s=PackSourceEnum_CREATOR_CENTER&se=f"
]
},
"create_time": "1793247804",
"description": "纸质照片拿在手里的感觉,还是和电子版完全不一样 神牛新出的照片打印机,模特都夸我返图快!\n#打印照片 #出片设备 #照片打印机 #神牛P100 #胶片",
"id": "7701940666704815843",
"type": 3
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Creator-V2-API/fetch_item_list_api_v1_douyin_creator_v2_fetch_item_list_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

