TikTok Fetch Post Detail

2.07 credits/call
ae_tiktok_fetch_post_detail

获取单个短视频作品的数据。 输入: - `itemId`(必填,字符串):作品 ID。 - `region`(可选,字符串):内容地区代码,例如 `US`、`GB`、`JP` 或 `ID`;默认值为 `US`。 返回: - `data`:作品数据。 - 同时可能包含请求状态、请求参数、时间和请求标识等响应元数据。 提示:返回数据中的 `video.playAddr`、`video.downloadAddr` 以及 `video` 下各 `UrlList` 的首个链接可直接访问,无需 Cookie。请求这些链接时不要携带 `tt_chain_token`,否则可能返回 HTTP 403;`UrlList` 中的其他链接可能需要额外凭据。

VideoSocial
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
itemIdstringYes作品id/Video id—
regionstringNo地区代码,可选;影响作品所属地区,如 US/GB/JP/ID 等,默认 US。/ Region code, optional; affects content region, e.g. US/GB/JP/ID, default US.US

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_post_detail' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "itemId": "7681547479745039629"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "extra": {
      "fatal_item_ids": [],
      "logid": "2026110709580970FDE052E5FC3B5C8B9A",
      "now": 1794045489000
    },
    "itemInfo": {
      "itemStruct": {
        "AIGCDescription": "",
        "CategoryType": 117,
        "IsHDBitrate": false,
        "ShowAIGC": true,
        "author": {
          "UserStoryStatus": 0,
          "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/a368de791f499518ff8c8d3ce635bcf7~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=7bed6667&x-expires=1794214800&x-signature=Xms6Q6uZH9ca3mgHmZT7Vayc%2FYU%3D&t=4d5b0474&ps=13740610",
          "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/a368de791f499518ff8c8d3ce635bcf7~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=4c74e180&x-expires=1794214800&x-signature=mktA1jydAjT6Nj8wa9fRinqmJzk%3D&t=4d5b0474&ps=13740610&shp",
          "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/a368de791f499518ff8c8d3ce635bcf7~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=62a075f6&x-expires=1794214800&x-signature=vFELznUmgT5cMXGsS1d0yuaZXLM%3D&t=4d5b0474&ps=13740610&shp",
          "commentSetting": 0,
          "id": "7552774087359022094"
        },
        "authorStats": {
          "diggCount": 120,
          "followerCount": 265900,
          "followingCount": 10,
          "friendCount": 0,
          "heart": 927400,
          "heartCount": 927400
        }
      }
    }
  },
  "docs": "https://api.tikhub.io/#/TikTok-Web-API/fetch_post_detail_api_v1_tiktok_web_fetch_post_detail_get",
  "message": "Request successful. This request will incur a charge."
}

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