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` 中的其他链接可能需要额外凭据。
2.07 credits/call
Pricing
2.07 credits/call
| 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 |
|---|---|---|---|---|
itemId | string | Yes | 作品id/Video id | — |
region | string | No | 地区代码,可选;影响作品所属地区,如 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-KeyRequest 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
{
"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.

