TikTok Scraper

TikTok Scraper

Collect TikTok video, hashtag, and profile video data in one CoreClaw Worker. Use it to monitor hashtag trends, inspect creator activity, collect public video metadata, and export engagement metrics for research, lead generation, social listening, or content analysis.

The scraper supports three collection modes:

• Hashtag: collect videos from a TikTok hashtag keyword or hashtag URL.
• User: collect videos or reposts from a TikTok profile.
• Video: collect details for one or more TikTok video URLs, with an option to include related videos.

What You Can Get

Each result row can include the TikTok video URL, profile URL, video ID, author ID, username, nickname, caption, hashtags, publish time, duration, play count, like count, comment count, share count, collect count, repost count, account verification status, private-account flag, profile signature, avatar URLs, follower count, following count, profile heart count, profile video count, music metadata, cover image, video dimensions, ad/pinned/slideshow/sponsored flags, collected comments, execution status, and the full normalized source payload.

Hashtag runs also include hashtag metadata such as the resolved hashtag name and view count when available.

How to Use It

1. Choose a collection type: hashtag, user, or video.
2. Enter one or more targets in the target list.
3. Set the relevant limit and optional filters.
4. Run the Worker and export the result table.

Targets are interpreted by mode:

• Hashtag mode accepts keywords such as fyp, travel, skincare, or full URLs such as https://www.tiktok.com/tag/fyp.
• User mode accepts usernames, @usernames, or profile URLs such as https://www.tiktok.com/@tiktok.
• Video mode accepts full TikTok video URLs.

Input Options

Collection Type

Select what kind of TikTok data to collect:

• hashtag: videos from a hashtag page.
• user: videos or reposts from a profile.
• video: one or more specific video URLs.

Targets

Enter one target per line. The same target field is used across all modes.

Hashtag Options

• fetch_count: maximum number of hashtag videos to collect.

Comment Options

• fetch_comments: enable comment collection.
• comment_max_per_post: maximum total comments per video.
• comment_top_level_max_per_post: maximum top-level comments per video.
• comment_reply_max_per_comment: maximum replies kept under each top-level comment.
• comment_max_pages: maximum comment pages to request per video.

Comment data is returned in the comments_json field as a JSON string.

User Options

• video_fetch_count: maximum videos to collect from a profile.
• profile_scrape_section: choose Videos or Reposts.
• profile_video_sort: choose Latest, Popular, or Oldest.
• exclude_pinned_posts: remove pinned posts from the final result.
• filter_publish_after_date: keep only videos published after a date.
• filter_publish_before_date: keep only videos published before a date.
• filter_heart_gte_than: keep only videos with like count greater than or equal to a threshold.
• filter_heart_less_than: keep only videos with like count below a threshold.

The follower and following list parameters are accepted by the form, but the current Worker does not return follower-list or following-list rows. The output fields for those lists are currently empty JSON arrays.

Video Options

• scrape_related_videos: collect related videos for each input video.

Example Inputs

Hashtag Videos

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

Hashtag Videos With Comments

{
  "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
}

Profile Videos

{
  "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
}

Specific Video

{
  "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
}

Output Fields

Common output fields include:

• 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

Best Practices

Start with a small fetch_count or video_fetch_count to confirm that your target is reachable. Enable comment collection only when you need comment text, because it requires extra requests and can increase runtime. For profile runs, use date and like-count filters to narrow down high-volume accounts.

TikTok changes its public web endpoints frequently. If a target returns no data or failed rows, try a smaller input, confirm the URL is publicly accessible, and rerun later.