TikTok Fetch User Post

2.07 credits/call
ae_tiktok_fetch_user_post

获取指定用户的作品列表,按发布时间从新到旧返回。 输入: - `secUid`:用户标识,必填。 - `cursor`:分页游标,首次请求使用 `0`,后续使用上一次结果中的 `cursor`,默认 `0`。 - `count`:每页数量,默认 `15`;超过 `15` 时按 `15` 处理。 - `coverFormat`:封面格式,默认 `2`。 - `post_item_list_request_type`:已废弃,不影响排序结果。 返回:作品列表、下一页 `cursor` 和 `hasMore`。当 `hasMore` 为 `false` 时表示没有更多作品。相邻页面可能出现少量重复作品,统计或保存前请按作品 `id` 去重。

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
countintegerNo每页数量,最大15/Number per page, max 1515
cursorintegerNo翻页游标/Page cursor0
secUidstringYes用户secUid/User secUid—
coverFormatintegerNo封面格式/Cover format2
post_item_list_request_typeintegerNo排序方式(已废弃,不再生效)/Sort type (deprecated, no longer effective)0

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_tiktok_fetch_user_post' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "extra": {
      "logid": "202611040947332C14D02CD3B6EC038BDE",
      "now": 1793785653000
    },
    "hasMorePrevious": true,
    "itemList": [
      {
        "CategoryType": 120,
        "IsHDBitrate": false,
        "ShowAIGC": true,
        "author": {
          "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=0a223b21&x-expires=1793955600&x-signature=2CZ0o57JLArZ2a2ZNGeDvE20NfE%3D&t=4d5b0474&ps=13740610&s",
          "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=bae197ed&x-expires=1793955600&x-signature=tNdmO66X0LXoCeN5PTFn0OX5Mtw%3D&t=4d5b0474&ps=13740610&shp",
          "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=87543bfb&x-expires=1793955600&x-signature=5YmKGuVuHA48bRNyqediWxJQ52Q%3D&t=4d5b0474&ps=13740610&shp",
          "commentSetting": 0,
          "downloadSetting": 0,
          "id": "107955"
        },
        "authorStats": {
          "diggCount": 4381,
          "followerCount": 96600000,
          "followingCount": 1,
          "friendCount": 0,
          "heart": 467100000,
          "heartCount": 467100000
        },
        "authorStatsV2": {
          "diggCount": "4381",
          "followerCount": "96600000",
          "followingCount": "1",
          "friendCount": "0",
          "heart": "467100000",
          "heartCount": "467100000"
        }
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/TikTok-Web-API/fetch_user_post_api_v1_tiktok_web_fetch_user_post_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.