Douyin Fetch Creator Item List

2.07 credits/call
ae_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.

SocialVideo
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes投稿作品列表请求参数/Item list request parameters—
request_body.countintegerNo每页数量/Count per page (最多100条)10
request_body.cookiestringYes用户Cookie/User Cookie—
request_body.cursorinteger | nullNo分页游标/Pagination cursor (可选)—
request_body.fieldsstringNo需要返回的字段/Fields to returnmetrics,review,visibility
request_body.end_timeintegerYes结束时间戳(毫秒)/End time timestamp (milliseconds)—
request_body.order_byintegerNo排序方式/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_timeintegerYes开始时间戳(毫秒)/Start time timestamp (milliseconds)—
request_body.need_cooperationbooleanNo是否需要合作信息/Need cooperation infotrue
request_body.need_long_articlebooleanNo是否包含长图文/Include long articlestrue

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.