获取已授权的 TTO 视频表现数据

您可以使用本接口接口获取已加入 TikTok One（TTO）的 TikTok 达人视频表现数据。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tto/creator/authorized/video/list/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|由 TikTok 创作者授权的访问令牌。<br>使用 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-获取创作者访问令牌) 或 [/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-刷新创作者访问令牌) 接口获取或刷新访问令牌。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|creator_id {必填}|string|TikTok 账号的应用唯一识别 ID。<br><br>将 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-获取创作者访问令牌) 或 [/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-刷新创作者访问令牌) 接口返回的 `open_id` 字段值传入此字段。|
|video_ids|string[]|要获取表现数据的视频 ID 列表。<br><br>如果提供了 `video_ids`，`limit` 和 `cursor` 参数将被忽略。|
|limit|integer|每次请求要获取的视频数量。<br><br>取值范围：1-10。<br>默认值：10。|
|cursor|integer|时间戳游标。<br>返回时间戳值（毫秒）之前的视频，按时间倒序排列。<br>默认值为 0，返回最新的视频。|

示例

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/tto/creator/authorized/video/list/?creator_id={{creator_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整的返回码及说明列表，参见 [附录 - 返回码](1737172488964097.html)。|
|message|string|返回消息。详情参见 [附录 - 返回码](1737172488964097.html)。|
|request_id |string|请求的日志 ID，唯一标识该请求。|
|data |object|返回的数据。|
#|posts|object[]|创作者 TikTok 账号内的帖子列表。|
##|video_id|string|视频的唯一标识符。|
##|display_name|string|创作者的显示名称（昵称）。|
##|thumbnail_url|string|创作者头像的临时链接。<br>链接中的 `x-expires` 参数后包含过期时间，格式为以秒为单位的 Epoch/Unix 时间戳。<br><br>有效期：约 7 天。|
##|embed_url|string|该 TikTok 视频的可嵌入链接，可用于在外部网站或应用中嵌入该视频。|
##|caption|string|视频描述。|
##|likes|number|点赞数。<br>视频的总点赞数。|
##|comments|number|评论数。<br>视频的总评论数。|
##|shares|number|分享数。<br>视频被分享的总次数。|
##|video_views|number|视频观看次数。<br>视频被观看的次数。|
##|favorites|number|收藏数。<br>视频被添加到收藏的总次数。|
##|create_time|string|视频创建时间，格式为以毫秒为单位的 Epoch/Unix 时间戳。<br><br>示例：`1749206540000`。|
##|caption_hashtags|string[]|帖子文案中出现的标签列表。
##|mentioned_accounts|string[]|帖子文案中提及（@）的 TikTok 账号的显示名称列表。
##|collaboration_status|string|一个状态，指示该帖是否用于品牌内容。<br><br>枚举值：<ul><li>`PAID_PARTNERSHIP`：TTO 营销活动链接关联的帖子。</li><li>`CREATOR_EARNS_COMMISSION`：TikTok 店铺的创作者通过联盟链接获得佣金，点击[此处](https://ads.tiktok.com/help/article/faqs-affiliate-creatives-authorization?lang=zh)了解更多。</li><li>`NONE`</li>
#|has_more|boolean|是否有下一页数据。<br><br>支持的取值：`true`、`false`。|
#|cursor|integer|时间戳游标。根据当前请求，返回的最后一条数据的时间值（毫秒）。<br>您需要在后续请求中使用此游标值以获取剩余视频。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "cursor": 1743739292000,
        "has_more": false,
        "posts": [
            {
                "caption": "",
                "comments": 0,
                "create_time": "1749206540000",
                "display_name": "{{display_name}}",
                "embed_url": "{{embed_url}}",
                "favorites": 0,
                "likes": 0,
                "shares": 0,
                "thumbnail_url": "{{thumbnail_url}}",
                "video_id": "{{video_id}}",
                "video_views": 0
            },
            {
                "caption": "",
                "comments": 0,
                "create_time": "1743739292000",
                "display_name": "{{display_name}}",
                "embed_url": "{{embed_url}}",
                "favorites": 0,
                "likes": 0,
                "shares": 0,
                "thumbnail_url": "{{thumbnail_url}}",
                "video_id": "{{video_id}}",
                "video_views": 1
            }
        ]
    }
}
(/code)