Douyin-Xingtu-V2-API
批量获取视频数据(播放量/点赞等)/Multi Get Item Stats
Changed on[中文]
用途:
- 批量获取视频(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"]
post/api/v1/douyin/xingtu_v2/multi_get_item_stats
Request
- Base URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Request body
Response
Successful Response
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info