TikTok Follower Scraper

Scrape follower data from TikTok user profiles using the SociaVault API. This actor retrieves detailed follower information with automatic pagination.

Overview

This actor scrapes follower lists for given TikTok usernames. It returns comprehensive profile data for each follower, including bios, counts, and profile pictures. It handles multiple profiles in a single run and manages pagination automatically.

Key Features

• Multi-Profile Scraping: Process multiple TikTok handles in one execution.
• Automatic Pagination: Fetches multiple pages of followers until the requested count is reached.
• Detailed Data: Returns extensive profile information for each follower.
• Built-in Rate Management: Includes delays to help avoid API rate limits.
• Error Handling: Failed profiles are logged with error details without stopping the entire run.

How to Use

Input Configuration

Configure the actor run using the following input parameters.

Note: The maxFollowersPerProfile limit applies to each handle individually. For example, 3 handles with a limit of 50 will attempt to fetch 150 total followers.

Example Input

{
  "handles": ["charlidamelio", "khaby.lame", "bellapoarch"],
  "maxFollowersPerProfile": 50
}

Output

The dataset contains one item per TikTok handle. Each item includes the following structure.

Follower Profile Object

Each object in the followerList contains these key fields:
* unique_id: The follower's TikTok username.
* nickname: The follower's display name.
* signature: Bio or description.
* follower_count: Number of accounts following this user.
* following_count: Number of accounts this user follows.
* uid & sec_uid: Unique user identifiers.
* avatar_medium: URLs for the profile picture.
* region: Country/region.
* language: Account language.
* create_time: Account creation timestamp.

Example Output (Successful)

{
  "success": true,
  "handle": "charlidamelio",
  "totalFollowers": 155000000,
  "followerCount": 50,
  "followerList": [
    {
      "unique_id": "user123",
      "nickname": "Cool User",
      "signature": "Just having fun!",
      "follower_count": 1500,
      "following_count": 300,
      "uid": "7234567890123456789",
      "sec_uid": "MS4wLjABAAAA...",
      "avatar_medium": { ... },
      "region": "US",
      "language": "en"
    }
  ]
}

Example Output (Failed)

If a handle fails to scrape, an error object is returned.

{
  "success": false,
  "handle": "invalidhandle",
  "error": "Error message"
}

Built with ️ by SociaVault