代码手册
简介
TikTok 支持对本平台的独立研究。符合资格的研究人员可以利用 TikTok 研究工具,基于非营利目的研究 TikTok 内容和账号的公开数据。本文介绍 TikTok 向研究人员提供的研究工具功能。
资格要求与数据访问权限
如需查看你的资格和获取资格的流程,请前往产品页面。
可用于研究的内容
视频
分析单元
由年满 18 周岁的公开创作者发布的展示给所有 TikTok 用户的公开 TikTok 视频。
范围
来自 TikTok 且符合以下条件的视频:
- 由年满 18 周岁的创作者公开发布;
- 发布于美国、欧洲和其他地区。
注意:研究工具会返回平台上的所有公开视频,包括不符合进入【推荐】页条件的或正在事实核查员审查中的视频。
详细信息
- ID:TikTok 视频的唯一标识符,也称为 item_id 或 video_id。
- Create Time:视频的创建时间。
- Username:视频创作者的用户名。
- Region Code:视频创作者账号的注册国家/地区的两位数代码。点击此处了解地区代码详情。
- Video Description:视频的描述。
- Music ID:视频中使用的 music_id。
- Like Count:用户通过点击【点赞】图标为 TikTok 视频点赞的总数。
- Comment Count:视频收到的评论总数。
- Share Count:用户通过点击视频的【分享】按钮分享 TikTok 视频的总次数。
- View Count:TikTok 视频的总播放量。
- Effect_IDs:视频使用的特效列表。
- Video ID:发布在 TikTok 上的每个视频的唯一 ID。该 ID 可用于重建视频的访问 URL。
- Hashtags:视频中使用的话题标签列表。
- Hashtag_id:每个话题标签的唯一 ID。
- Hashtag_description:如果话题标签有描述,则返回相应描述。
- Video_mention_list:视频中提及的其他用户。
- Video_label:添加至视频的标签,例如“选举标签”(示例:Get info on the U.S elections)。
- Playlist_ID:视频所属播放列表的 ID。
- Voice_to_text:语音转文本和字幕(已开启语音转文本功能的视频将显示生成的文本)。
- Is_stem_verified:视频是否已认证为高质量 STEM 内容。
- Video_duration:视频的时长(单位:秒)。
- Favorites_count:视频被收藏的次数。
评论
分析单元
在 TikTok 上公开发布的视频的评论或对评论的回复。
范围
此处提供的信息包括从评论中提取的文本内容,以及有助于识别视频原始评论及所有评论回复的序列号(即评论 ID)。为保护用户隐私,其他信息均已移除。
详细信息
- Create Time:评论发布至视频的时间。
- ID:在视频下发布的评论的唯一 ID。
- Like Count:视频下某条评论的总点赞数,由用户点击【点赞】图标产生。
- Parent Comment ID:用户回复另一用户的评论时,父评论的唯一 ID。如果评论直接发布在视频下,则此 ID 与视频 ID 相同。
- Reply Count:某条评论的总回复数。
- Text:视视频下发布的评论的实际文字内容。为保护用户隐私,其他信息均已移除。
- Video_ID:评论所属视频的 ID。
用户
分析单元
所有已将账号设为公开且年满 18 周岁的 TikTok 用户的信息。
范围
可通过此 API 访问年满 18 周岁的公开用户的公开详细信息。
详细信息
- Following Count:公开用户的已关注账号数。
- Likes Count:用户的累计获赞数。
- Video Count:用户在其 TikTok 账号上发布的总视频数。
- Bio Description:用户个人简介中的描述。如果用户没有描述,则返回空白内容。
- Display Name:位于用户名下方的用户主页名称。
- Follower Count:用户的总粉丝数。
- Avatar URL:用户图片头像的 URL。
- Is Verified:表示用户是否已通过验证。所有已验证用户的用户名旁均会显示“蓝勾”标记。若查询的是蓝勾用户,此变量将在响应中返回“true”值。
- Bio_URL:用户个人简介中的公开 URL。
赞过的视频
分析单元
年满 18 周岁且已将账号设为公开的 TikTok 用户点赞视频的详细信息。
范围
此 API 可访问年满 18 周岁的公开用户的点赞视频详情。
详细信息
- ID:TikTok 视频的唯一标识符,也称为 item_id 或 video_id。
- Create Time:视频的创建时间。
- Username:视频创作者的唯一用户名。
- Region Code:视频创作者账号的注册国家/地区的两位数代码。点击此处了解地区代码详情。
- Video Description:赞过的视频的描述。
- Music ID:视频中使用的 music_id。
- Like Count:用户通过点击【点赞】图标为 TikTok 视频点赞的总数。
- Comment Count:视频收到的评论总数。
- Share Count:用户通过点击视频的【分享】按钮分享 TikTok 视频的总次数。
- View Count:TikTok 视频的总播放量。
- Hashtag Names:视频中使用的话题标签列表。
- Hashtag_id:话题标签的唯一 hashtag_id。
- Hashtag_description:如果话题标签有描述,则返回相应描述。
- Video_mention_list:视频中提及的其他用户。
- Video_label:添加至视频的标签,例如“选举标签”(示例:Get info on the U.S elections)。
- Is_stem_verified:视频是否已认证为高质量 STEM 内容。
- Video_duration:视频的时长(单位:秒)。
- Favorites_count:视频被收藏的次数。
转发的视频
分析单元
年满 18 周岁且账号设置为公开的 TikTok 用户的转发视频详情。
范围
此 API 可访问年满 18 周岁的公开用户的转发视频详情。
详细信息
- ID:TikTok 视频的唯一标识符,也称为 item_id 或 video_id。
- Create Time:视频的创建时间。
- Username:视频创作者的唯一用户名。
- Region Code:视频创作者账号的注册国家/地区的两位数代码。点击此处了解地区代码详情。
- Video Description:赞过的视频的描述。
- Music ID:视频中使用的 music_id。
- Like Count:用户通过点击【点赞】图标为 TikTok 视频点赞的总数。
- Comment Count:视频收到的评论总数。
- Share Count:用户通过点击视频的【分享】按钮分享 TikTok 视频的总次数。
- View Count:TikTok 视频的总播放量。
- Hashtag Names:视频中使用的话题标签列表。
- Hashtag_id:话题标签的唯一 hashtag_id。
- Hashtag_description:如果话题标签有描述,则返回相应描述。
- Video_mention_list:视频中提及的其他用户。
- Video_label:添加至视频的标签,例如“选举标签”(示例:Get info on the U.S elections)。
- Is_stem_verified:视频是否已认证为高质量 STEM 内容。
- Video_duration:视频的时长(单位:秒)。
- Favorites_count:视频被收藏的次数。
置顶视频
分析单元
将账号设为公开且年满 18 周岁的 TikTok 用户的置顶视频详情。
范围
此 API 可访问年满 18 周岁的公开用户的置顶视频详情。
详细信息
- ID:TikTok 视频的唯一标识符,也称为 item_id 或 video_id。
- Create Time:视频的创建时间。
- Username:视频创作者的用户名。
- Region Code:视频创作者账号的注册国家/地区的两位数代码。点击此处了解地区代码详情。
- Video Description:置顶视频的描述。
- Music ID:视频中使用的 music_id。
- Like Count:用户通过点击【点赞】图标为 TikTok 视频点赞的总数。
- Comment Count:视频收到的评论总数。
- Share Count:用户通过点击视频的【分享】按钮分享 TikTok 视频的总次数。
- View Count:TikTok 视频的总播放量。
- Hashtag Names:视频中使用的话题标签列表。
- Hashtag_id:话题标签的唯一 hashtag_id。
- Hashtag_description:如果话题标签有描述,则返回相应描述。
- Video_mention_list:视频中提及的其他用户。
- Video_label:添加至视频的标签,例如“选举标签”(示例:Get info on the U.S elections)。
- Is_stem_verified:视频是否已认证为高质量 STEM 内容。
- Video_duration:视频的时长(单位:秒)。
- Favorites_count:视频被收藏的次数。
查询粉丝列表
年满 18 周岁且已将账号设为公开的 TikTok 用户的粉丝列表。
范围
此 API 可访问年满 18 周岁的公开用户的粉丝列表。
详细信息
- Display Name:所查询用户的粉丝的主页名称。
- Username:所查询用户的粉丝的用户名。
关注列表
将账号设为公开且年满 18 岁的 TikTok 用户的关注列表。仅支持查询设置为公开的关注列表。
范围
如果公开用户年满 18 周岁且已将其关注列表设为公开,可通过此 API 访问该列表。
详细信息
- Display Name:所查询用户的已关注账号的主页名称。
- Username:所查询用户的已关注账号的用户名。
查询播放列表信息
获取账号的公开播放列表,以及播放列表中所有视频的信息。
范围
此 API 可访问所有用户公开可见的播放列表的详细信息。
详细信息
- Playlist_ID:播放列表的唯一 ID。
- Playlist_item_total:播放列表的总视频数。
- Playlist_last_updated:播放列表最近一次更新时间。
- Playlist_name:播放列表的名称。
- Playlist_Video_IDs:播放列表中所有视频的 ID。