tiktok 多功能接口

TikTok 数据采集器

这个 CoreClaw Worker 可以在一个工具里采集 TikTok 的标签视频、用户主页视频和指定视频详情，适合做热门内容追踪、创作者分析、社媒监听、竞品内容研究、营销线索筛选和数据导出。

当前支持三种采集模式：

• 标签模式：根据 TikTok 标签关键词或标签链接采集视频列表。
• 用户模式：根据 TikTok 用户名或主页链接采集主页视频或转发内容。
• 视频模式：根据一个或多个 TikTok 视频链接采集视频详情，也可以选择采集相关视频。

可以采集哪些数据

每条结果可以包含 TikTok 视频链接、主页链接、视频 ID、作者 ID、用户名、昵称、标题/文案、标签、发布时间、视频时长、播放量、点赞数、评论数、分享数、收藏数、转发数、账号认证状态、是否私密账号、个人签名、头像链接、关注数、粉丝数、主页总获赞数、主页视频数、音乐信息、封面图、视频尺寸、广告/置顶/图集/赞助标记、评论数据、运行状态，以及完整的标准化原始数据。

标签模式还会在可用时返回当前标签的元信息，例如标签名称和浏览量。

如何使用

1. 选择采集类型：hashtag、user 或 video。
2. 在目标列表中输入一个或多个目标。
3. 根据采集类型设置数量、评论、筛选等参数。
4. 运行 Worker，并在结果表中查看或导出数据。

不同模式下，目标的填写方式如下：

• 标签模式：填写标签词，例如 fyp、travel、skincare，也可以填写完整标签链接，例如 https://www.tiktok.com/tag/fyp。
• 用户模式：填写用户名、@用户名 或主页链接，例如 https://www.tiktok.com/@tiktok。
• 视频模式：填写完整 TikTok 视频链接。

输入参数说明

采集类型

选择要采集的数据类型：

• hashtag：采集标签页视频。
• user：采集用户主页视频或转发内容。
• video：采集指定视频链接的数据。

目标列表

每行填写一个目标。标签、用户和视频模式共用同一个目标列表。

标签采集参数

• fetch_count：标签模式下最多采集多少条视频。

评论采集参数

• fetch_comments：是否采集评论。
• comment_max_per_post：每条视频最多采集多少条评论。
• comment_top_level_max_per_post：每条视频最多采集多少条一级评论。
• comment_reply_max_per_comment：每条一级评论下最多保留多少条回复。
• comment_max_pages：每条视频最多请求多少页评论。

评论数据会以 JSON 字符串形式返回在 comments_json 字段中。

用户主页参数

• video_fetch_count：用户模式下最多采集多少条视频。
• profile_scrape_section：选择采集 Videos 或 Reposts。
• profile_video_sort：选择 Latest、Popular 或 Oldest。
• exclude_pinned_posts：是否从结果中排除置顶视频。
• filter_publish_after_date：只保留该日期之后发布的视频。
• filter_publish_before_date：只保留该日期之前发布的视频。
• filter_heart_gte_than：只保留点赞数大于等于该阈值的视频。
• filter_heart_less_than：只保留点赞数小于该阈值的视频。

粉丝列表和关注列表相关参数目前可以被表单接收，但当前 Worker 不会返回粉丝列表或关注列表明细；对应输出字段目前为空 JSON 数组。

视频参数

• scrape_related_videos：是否为输入视频采集相关视频。

输入示例

采集标签视频

{
  "collection_type": "hashtag",
  "targets": [
    { "string": "fyp" }
  ],
  "fetch_count": 10,
  "fetch_comments": false,
  "retry_times": 3,
  "retry_delay_seconds": 1
}

采集标签视频和评论

{
  "collection_type": "hashtag",
  "targets": [
    { "string": "travel" }
  ],
  "fetch_count": 5,
  "fetch_comments": true,
  "comment_max_per_post": 20,
  "comment_top_level_max_per_post": 10,
  "comment_reply_max_per_comment": 2,
  "comment_max_pages": 2,
  "retry_times": 3,
  "retry_delay_seconds": 1
}

采集用户主页视频

{
  "collection_type": "user",
  "targets": [
    { "string": "@tiktok" }
  ],
  "video_fetch_count": 10,
  "profile_scrape_section": "Videos",
  "profile_video_sort": "Latest",
  "exclude_pinned_posts": false,
  "filter_publish_after_date": "",
  "filter_publish_before_date": "",
  "retry_times": 3,
  "retry_delay_seconds": 1
}

采集指定视频

{
  "collection_type": "video",
  "targets": [
    { "string": "https://www.tiktok.com/@tiktok/video/7280572837598170398" }
  ],
  "fetch_comments": true,
  "comment_max_per_post": 20,
  "comment_top_level_max_per_post": 10,
  "comment_reply_max_per_comment": 2,
  "comment_max_pages": 2,
  "scrape_related_videos": false,
  "retry_times": 3,
  "retry_delay_seconds": 1
}

输出字段

常见输出字段包括：

• mode、input_value、status、error
• url、profile_url、entity_id、video_id、author_id
• username、nickname、signature、verified、private_account
• title、desc、tag、create_time、create_time_iso、duration
• play_count、digg_count、comment_count、share_count、collect_count、repost_count
• following_count、friends_count、fans_count、heart_count、video_count
• music_name、music_author、music_id、music_play_url
• cover_url、width、height
• is_ad、is_pinned、is_slideshow、is_sponsored
• search_hashtag、comments_json、data_json

使用建议

第一次测试建议先使用较小的 fetch_count 或 video_fetch_count，确认目标可以正常访问后再放大采集量。只有在需要评论内容时再开启评论采集，因为评论采集会增加请求量和运行时间。采集用户主页时，可以配合发布时间和点赞数筛选，减少无关结果。

TikTok 的公开网页接口变化较频繁。如果某个目标返回空结果或失败行，建议先确认链接是否公开可访问，再尝试缩小输入范围或稍后重试。