批量获取视频数据(播放量/点赞等)/Multi Get Item Stats

[中文]

用途:

• 批量获取视频(item)的播放量等统计与详情，一次最多20个，节省调用次数
• 每条含 stats（watch_cnt 播放量 / like_cnt 点赞 / comment_cnt 评论 / share_cnt 转发 / favorite_cnt 收藏 / interact_rate 互动率 / avg_watch_dura 人均观看时长）及视频详情
• 注意：watch_cnt 为含投流(广告加热)的总播放量，并附带作品详情；如需未投流(自然) 播放量，请调用抖音App V3 的 /api/v1/douyin/app/v3/fetch_multi_video_statistics
• 上游按20条计费，不足20也按20算，建议尽量凑满20个再请求
• 价格：0.04$ / 次（= 20 × 单个 0.002）

参数:

• item_ids: 视频(item) ID列表，一次最多20个，超出会报错；自动去空、去重
• platform_source: 平台来源，默认1
• need_cover_url: 是否返回封面URL，默认true

返回:

• items: 命中的视频列表，每条含 stats 与视频详情（无效/已删除ID会被上游丢弃）

[English]

Purpose:

• Batch get play count and details for multiple videos (items), up to 20 per call
• Each item has stats (watch_cnt/like_cnt/comment_cnt/share_cnt/favorite_cnt/ interact_rate/avg_watch_dura) and video details
• Note: watch_cnt is the total play count INCLUDING paid promotion (ad boost), with video details; for organic (non-promoted) play count, use Douyin App V3 /api/v1/douyin/app/v3/fetch_multi_video_statistics
• Upstream bills as 20 regardless (fewer than 20 still counts as 20); fill 20 for best value
• Price: 0.04$ / time (= 20 × single 0.002)

Parameters:

• item_ids: Video (item) ID list, up to 20 per call (exceeding returns an error); auto de-dup
• platform_source: Platform source, default 1
• need_cover_url: Whether to return cover URL, default true

Return:

• items: Matched video list, each with stats and video details (invalid/deleted IDs are dropped upstream)

[示例/Example]

item_ids = ["7630036460159111515", "7634126662552474854"]

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.