TikTok Comment Scraper

Scrapes comments from TikTok videos using the SociaVault API. Retrieves detailed comment data including text, user profiles, likes, reply counts, and timestamps with automatic pagination.

Key Features

• Multi-Video Support: Scrape comments from multiple video IDs in a single run.
• Automatic Pagination: Fetches multiple pages automatically to reach your specified comment count.
• Detailed Data: Returns comprehensive information for each comment and the commenting user.
• Built-in Rate Limiting: Includes configurable delays to prevent hitting API limits.
• Error Handling: Gracefully handles API failures and logs errors for troubleshooting.

How to Use

Provide an input configuration specifying the video IDs and how many comments to fetch per video.

Input Parameters

Note: If you set maxCommentsPerVideo: 100 and provide 2 video IDs, the scraper will fetch up to 100 comments for each video (200 total).

Example Input

{
  "videoIds": ["7488736374602927402", "7123456789012345678"],
  "maxCommentsPerVideo": 100
}

Input/Output

Output Structure

For each video processed, the actor outputs an object with the following fields:

Comment Object

Each item in the comments array contains:
* aweme_id: The video ID.
* text: The comment text.
* user: An object with user details (unique_id, nickname, uid, sec_uid, avatar_thumb).
* create_time: Unix timestamp of the comment.
* digg_count: Number of likes on the comment.
* reply_comment_total: Number of replies to this comment.
* comment_language: Detected language of the comment (e.g., "en").

Example Output

{
  "success": true,
  "videoId": "7488736374602927402",
  "totalComments": 925,
  "commentCount": 100,
  "comments": [
    {
      "aweme_id": "7488736374602927402",
      "text": "This is awesome!",
      "user": {
        "unique_id": "cooluser123",
        "nickname": "Cool User",
        "uid": "7151557610473800750",
        "sec_uid": "MS4wLjABAAAA...",
        "avatar_thumb": { ... }
      },
      "create_time": 1743795517,
      "digg_count": 784,
      "reply_comment_total": 3,
      "comment_language": "en"
    }
  ]
}

Performance & Limitations

• Processing: Videos are processed sequentially, not in parallel.
• Delays: A 500ms delay is added between pagination requests, and a 1-second delay between different videos to respect rate limits.
• Comment Limit: The maxCommentsPerVideo parameter controls the maximum fetched per video.
• Order: Comments are typically returned in chronological order (newest first).
• Nested Replies: Only top-level comments are retrieved; nested reply threads are not included.
• Disabled Comments: Some videos may have comments disabled, resulting in empty results.

Use Cases

• Sentiment analysis for brand or content monitoring.
• Tracking engagement metrics and comment patterns.
• Content research based on audience reaction.
• Trend analysis within video comments.
• Evaluating influencer engagement.
• Community feedback monitoring and management.

Error Handling

The actor includes error handling for common issues:
* Invalid API keys or configuration.
* Missing videoIds input.
* Individual API request failures (the actor logs the error and continues with the next video).
Failed video scrapes return an error object in the dataset for diagnosis.