[中文]

用途:

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

参数:

• item_id: 视频ID，从 /get_top_contents_list 返回的 itemInfo.itemID 获取
• period_end_timestamp: 榜单周期结束时间戳(10位秒级)，必填
  • 该参数需调用方根据目标榜单日期自行生成，并非由其他接口返回
  • 示例: 1785024000；不要传 0，否则会返回空结果
  • period_dimension 为 1 时需传周日 00:00 UTC 的时间戳，其余日期无数据
  • period_dimension 为 3 或 5 时可传任意已过去日期的时间戳
  • 若 item_id 来自 /get_top_contents_list，请沿用查询榜单时的时间戳
• 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
  • Generate this value from the target ranking date; it is not returned by another endpoint
  • Example: 1785024000; do not pass 0, which returns an empty result
  • For period_dimension 1, pass a Sunday 00:00 UTC timestamp; other dates return no data
  • For period_dimension 3 or 5, any past date works
  • If item_id comes from /get_top_contents_list, reuse that ranking query's timestamp
• 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)

{
  "period_end_timestamp": 1785024000,
  "period_dimension": 1
}