← 返回目录
📁 API Reference › Identity

获取 TikTok 帖子信息

您可以使用本接口获取通过AUTH_CODE，TT_USER或BC_AUTH_TT类型的认证身份下的 TikTok 帖子的信息。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/identity/video/info/| /v1.3/identity/video/info/| | 请求参数类型 |advertiser_id: number |advertiser_id: string | | 请求参数类型|item_id: number |item_id: string | | 新增请求参数 | / |item_ids| | 返回参数名称|item_info|video_detail| | 返回参数类型|item_id: number |item_id: string | | 返回参数名称和类型 |id: number |anchor_id: string | | 新增返回参数 | / |video_details<br>item_type<br>carousel_info`（包含本对象数组内的所有参数） |


## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/identity/video/info/

**方法** GET

**Header**

```xtable
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string |广告主 ID。|
| identity_type  {必填} | string | 认证身份类型。<br><br>枚举值： `AUTH_CODE`, `TT_USER`, `BC_AUTH_TT`。<br><br>获取更多相关信息，请访问[认证身份](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)。 |
| identity_id {必填}  | string | 认证身份 ID。<br><br>若想获取广告账户中的认证身份，可使用[/identity/get/](1740218420781057.html)。|
| identity_authorized_bc_id {+条件必填}| string | 当`identity_type`为`BC_AUTH_TT`时必填。<br><br>与添加到商务中心的 TikTok 用户这一认证身份绑定的商务中心的ID。|
| item_id{+条件必填} | string | `item_id` 和 `item_ids` 二者必传其一。<br><br><ul><li>若想获取单个 TikTok 帖子的信息，传入 `item_id`。</li><li>若想获取多个 TikTok 帖子的信息，传入 `item_ids`。</li></ul> <br>与指定的认证身份 ID （`identity_id`）绑定的 TikTok 帖子 ID。 <br><br>若想获取与某一认证身份绑定的 TikTok 帖子，可使用 [/identity/video/get/](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)，通过返回中的 `item_id` 字段获取 TikTok 帖子 ID。 |
| item_ids {+条件必填}  | string[] | `item_id` 和 `item_ids` 二者必传其一。<br><br><ul><li>若想获取单个 TikTok 帖子的信息，传入 `item_id`。</li><li>若想获取多个 TikTok 帖子的信息，传入 `item_ids`。</li></ul> <br> 与指定的认证身份 ID （`identity_id`）绑定的 TikTok 帖子 ID 列表。 <br><br>最大数量：20。 <br><br>若想获取与某一认证身份绑定的 TikTok 帖子，可使用[/identity/video/get/](https://ads.tiktok.com/marketing_api/docs?id=1738958351620097)，通过返回中的 `item_id` 字段获取 TikTok 帖子 ID。 |

示例

获取与TT_USER认证身份绑定的单个 TikTok 帖子的信息

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/video/info/?advertiser_id={{advertiser_id}}&identity_type=TT_USER&identity_id={{identity_id}}&item_id={{item_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

获取与AUTH_CODE认证身份绑定的单个 TikTok 帖子的信息

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/video/info/?advertiser_id={{advertiser_id}}&identity_type=AUTH_CODE&identity_id={{identity_id}}&item_ids=["{{item_id}}"]' \
--header 'Access-Token: {{Access-Token}}'
(/code)

获取与BC_AUTH_TT认证身份绑定的多个 TikTok 帖子的信息

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/identity/video/info/?advertiser_id={{advertiser_id}}&identity_type=BC_AUTH_TT&identity_id={{identity_id}}&identity_authorized_bc_id={{identity_authorized_bc_id}}&item_ids=["{{item_id}}","{{item_id}}"]' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id |string|请求的日志ID，唯一标识一个请求。|
|data|object|返回数据。|
#| video_detail | object | 请求中传入 `item_id` 字段时返回。<br><br>TikTok 帖子信息。|
##| item_type | string | TikTok 帖子类型。<br><br>枚举值： <ul><li> `VIDEO`：视频帖子。 </li><li>`CAROUSEL`：照片帖子。</li></ul> |
##| item_id | string | TikTok 帖子 ID。|
##| status | string | TikTok 帖子的可见状态。<br><br>枚举值：<ul><li>`ITEM_STATUS_HESITATE_RECOMMEND`：对所有人可见。</li><li>`STATUS_ONLY_FRIEND_SEE`：仅对好友可见。</li><li>`ITEM_STATUS_ONLY_AUTHOR_SEE`：仅自己可见。</li></ul> |
##| text | string | TikTok 帖子文案。|
##| anchor_list | object |锚点信息。 |
###| anchor_id | string | 锚点 ID。 |
###| title | string |   锚点标题。|
###| status | string | 锚点状态。<br><br>枚举值：`CHECK_ING`, `CHECK_FAILED`, `CHECK_SUCCESS`。|
###| url | string |锚点URL。|
###| product_regions | string[] |广告可投放区域列表，以国家或地区代码表示。例如：`["DE"]`。|
##| auth_info | object | 仅当请求中 `identity_type` 设置为 `AUTH_CODE` 时返回。<br><br>帖子授权信息。|
###| ad_auth_status | string | 授权状态。|
###| auth_start_time | string |授权码的有效期起始时间（基于 UTC+0 时区），格式为`"YYYY-MM-DD HH:MM:SS"`。|
###| auth_end_time | string | 授权码的有效期结束时间（基于 UTC+0 时区），格式为`"YYYY-MM-DD HH:MM:SS"`。|
###| invite_start_time| string | 授权生效时间（基于 UTC+0 时区），格式为`"YYYY-MM-DD HH:MM:SS"`。|
##| video_info | object |  视频帖子信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：`item_type` 为 `CAROUSEL` 时，本字段值为 null。|
###| bit_rate | integer | 比特率，单位为bps。|
###| duration | float| 视频时长，单位为秒。 |
###| size | integer | 视频尺寸，单位为比特。 |
###| height | integer| 视频高度。 |
###| width | integer| 视频宽度。 |
###| poster_url | string | 视频封面图片 URL。<br>URL 中的 `x-expires` 参数后会包含过期时间，格式为 Epoch/Unix 时间戳，单位为秒。<br>失效后，你需要再次调用本接口获取一个新的 URL。|
###| signature | string | 视频文件的 MD5 散列值。 |
###| url | string | 视频预览链接。<br><br>有效期：1 小时。失效后，您需要获取一个新的 URL。|
##| carousel_info | object | 照片帖子信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：`item_type` 为 `VIDEO` 时， 本字段值为 null。 |
###| image_info | object[] | 照片帖子中使用的图片的信息。<br><br>图片返回的顺序与在照片帖子中的顺序一致。 |
####| image_id | string | 图片 ID。 |
####| image_url | string | 图片 URL。<br><br>有效期：90 天。 |
####| image_height | integer | 图片高度，单位为像素。 |
####| image_width | integer | 图片宽度，单位为像素。 |
###| music_info | object | 照片帖子中使用的音乐的信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：若照片帖子是从 TikTok 应用中直接发布且无音乐的帖子，则本字段的值将为 null。 |
####| music_id | string | 音乐 ID。 |
####| music_url | string | 音乐 URL。<br><br>有效期：90 天。 |
####| music_duration | integer | 音乐时长，单位为秒。 |
#| video_details | object | 请求中传入 `item_ids` 字段时返回。<br><br>TikTok 帖子信息。|
##| item_type | string | TikTok 帖子类型。<br><br>枚举值： <ul><li> `VIDEO`：视频帖子。 </li><li>`CAROUSEL`：照片帖子。</li></ul> |
##| item_id | string | TikTok 帖子 ID。|
##| status | string | TikTok 帖子的可见状态。<br><br>枚举值：<ul><li>`ITEM_STATUS_HESITATE_RECOMMEND`：对所有人可见。</li><li>`STATUS_ONLY_FRIEND_SEE`：仅对好友可见。</li><li>`ITEM_STATUS_ONLY_AUTHOR_SEE`：仅自己可见。</li></ul> |
##| text | string | TikTok 帖子文案。|
##| auth_info | object | 仅当请求中 `identity_type` 设置为 `AUTH_CODE` 时返回。<br><br>帖子授权信息。|
###| ad_auth_status | string | 授权状态。|
###| auth_start_time | string |授权码的有效期起始时间（基于 UTC+0 时区），格式为`"YYYY-MM-DD HH:MM:SS"`。|
###| auth_end_time | string | 授权码的有效期结束时间（基于 UTC+0 时区），格式为`"YYYY-MM-DD HH:MM:SS"`。|
###| invite_start_time| string | 授权生效时间（基于 UTC+0 时区），格式为`"YYYY-MM-DD HH:MM:SS"`。|
##| video_info | object |  视频帖子信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：`item_type` 为 `CAROUSEL` 时，本字段值为 null。|
###| bit_rate |  integer | 比特率，单位为bps。|
###| duration | float| 视频时长，单位为秒。 |
###| size |  integer| 视频尺寸，单位为比特。 |
###| height |  integer | 视频高度。 |
###| width |  integer | 视频宽度。 |
###| poster_url | string | 视频封面图片 URL。<br>URL 中的 `x-expires` 参数后会包含过期时间，格式为 Epoch/Unix 时间戳，单位为秒。<br>失效后，你需要再次调用本接口获取一个新的 URL。|
###| signature | string | 视频文件的 MD5 哈希值。 |
###| url | string | 视频预览链接。<br><br>有效期：1 小时。失效后，您需要获取一个新的 URL。|
##| carousel_info | object | 照片帖子信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：`item_type` 为 `VIDEO` 时， 本字段值为 null。 |
###| image_info | object[] | 照片帖子中使用的图片的信息。<br><br>图片返回的顺序与在照片帖子中的顺序一致。 |
####| image_id | string | 图片 ID。 |
####| image_url | string | 图片 URL。<br><br>有效期：90 天。 |
####| image_height | integer | 图片高度，单位为像素。 |
####| image_width | integer| 图片宽度，单位为像素。 |
###| music_info | object | 照片帖子中使用的音乐的信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：若照片帖子是从 TikTok 应用中直接发布且无音乐的帖子，则本字段的值将为 null。 |
####| music_id | string | 音乐 ID。 |
####| music_url | string | 音乐 URL。<br><br>有效期：90 天。 |
####| music_duration |  integer | 音乐时长，单位为秒。 |

示例

获取与TT_USER认证身份绑定的单个 TikTok 帖子的信息

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "video_detail": {
            "auth_info": null,
            "anchor_list": null,
            "item_id": "{{item_id}}",
            "text": "",
            "status": "ITEM_STATUS_HESITATE_RECOMMEND",
            "video_info": {
                "duration": 1.6,
                "width": 720,
                "url": "{{url}}",
                "size": 244797,
                "bit_rate": 1223985,
                "height": 1280,
                "poster_url": "{{poster_url}}",
                "format": "mp4",
                "signature": "{{signature}}"
            }
        }
    }
}
(/code)

获取与AUTH_CODE认证身份绑定的单个 TikTok 帖子的信息

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "video_details": [
            {
                "item_type": "VIDEO",
                "anchor_list": null,
                "item_id": "{{item_id}}",
                "carousel_info": null,
                "status": "ITEM_STATUS_HESITATE_RECOMMEND",
                "text": "{{text}}",
                "auth_info": {
                    "auth_end_time": "2025-05-20T11:40:50Z",
                    "ad_auth_status": "AUTHORIZED",
                    "auth_start_time": "2024-05-20T11:40:50Z",
                    "invite_start_time": "2024-05-20T11:43:00Z"
                },
                "video_info": {
                    "height": 1920,
                    "width": 1080,
                    "url": "{{url}}",
                    "signature": "{{signature}}",
                    "size": 8119495,
                    "bit_rate": 9897296,
                    "format": "mp4",
                    "poster_url": "{{poster_url}}",
                    "duration": 6.563
                }
            }
        ]
    }
}
(/code)

获取与BC_AUTH_TT认证身份绑定的多个 TikTok 帖子的信息

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "video_details": [
            {
                "text": "{{text}}",
                "anchor_list": null,
                "status": "ITEM_STATUS_HESITATE_RECOMMEND",
                "auth_info": null,
                "video_info": {
                    "url": "{{url}}",
                    "height": 1024,
                    "format": "mp4",
                    "signature": "{{signature}}",
                    "width": 576,
                    "poster_url": "{{poster_url}}",
                    "duration": 8.474,
                    "size": 774110,
                    "bit_rate": 730809
                },
                "item_id": "{{item_id}}"
            },
            {
                "text": "",
                "anchor_list": null,
                "status": "ITEM_STATUS_HESITATE_RECOMMEND",
                "auth_info": null,
                "video_info": {
                    "url": "{{url}}",
                    "height": 1024,
                    "format": "mp4",
                    "signature": "{{signature}}",
                    "width": 576,
                    "poster_url": "{{poster_url}}",
                    "duration": 6.245,
                    "size": 913323,
                    "bit_rate": 1169989
                },
                "item_id": "{{item_id}}"
            }
        ]
    }
}
(/code)
← 获取音乐版权信息图片管理 →

内容来源：TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了？
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →