[中文]

用途:

获取热门视频榜单中单个视频的详细数据

在榜单数据基础上额外返回热门评论与作者主页信息，便于分析视频的受欢迎原因

参数:

item_id: 视频ID，从 /get_top_contents_list 返回的 itemInfo.itemID 获取

period_end_timestamp: 榜单周期结束时间戳(10位秒级)，必填

period_dimension: 榜单周期，可选 1 / 3 / 5，默认3，建议与查询榜单时保持一致

country_code: 该视频所属榜单的国家/地区代码，默认US

cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据

注意:

建议传入与查询榜单时相同的 country_code，例如从 TH 榜单取到的视频传 TH，可减少一次查询耗时

返回内容说明:

entityInfo: 视频详情

itemInfo: 视频基础信息 (itemID / title / createTime / coverURL / videoURL / authorID / creatorID)

itemMetrics: 视频指标 (videoViews / engagementRate / sixSecondsVTR 及各自的 LifeTime 累计值)

itemAuthorInfo: 作者信息 (nickName / handlerName / avatarURI / bio / storeRegion)

itemAuthorMetrics: 作者指标 (followers 粉丝数)

contentTags: 内容分类标签

commentInfos: 热门评论 (text / likeCnt / createTime / userName / userAvatarLink)

[English]

Purpose:

Get detailed data of a single video from the Top Contents ranking

Returns top comments and author profile on top of the ranking data

Parameters:

item_id: Video ID, obtained from itemInfo.itemID of /get_top_contents_list

period_end_timestamp: Period end timestamp in seconds, required

period_dimension: Period, one of 1 / 3 / 5, default 3, recommended to match the ranking query

country_code: Country code of the ranking the video belongs to, default US

cookie: Custom Cookie string, optional parameter, you can use your own Cookie to get more data

Note:

Prefer passing the same country_code used for the ranking query, e.g. TH for a video taken from the TH ranking, to avoid an extra lookup

Return Description:

entityInfo: Video detail (itemInfo / itemMetrics / itemAuthorInfo / itemAuthorMetrics / contentTags / commentInfos)

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/tiktok/ads/get_top_contents_item_detail' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "item_id": "string", "period_end_timestamp": 0, "period_dimension": 3, "country_code": "US", "cookie": "string" }'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取热门视频详情/Get top contents item detail

[中文]

用途:

参数:

注意:

返回内容说明:

[English]

Purpose:

Parameters:

Note:

Return Description:

Request

Responses

获取热门视频详情/Get top contents item detail

[中文]#

用途:#

参数:#

注意:#

返回内容说明:#

[English]#

Purpose:#

Parameters:#

Note:#

Return Description:#

Request

Responses

[中文]

用途:

参数:

注意:

返回内容说明:

[English]

Purpose:

Parameters:

Note:

Return Description: