TikTok User Search Scraper

Scrapes TikTok for user profiles based on a search keyword or name. It handles pagination automatically to collect detailed public profile data, useful for lead generation and social media analysis.

Overview

This actor performs searches on TikTok to find users and creators. You provide a search term, and it returns a list of user profiles with their public statistics and information. It uses the SociaVault API to fetch data and includes built-in rate limiting.

Key Features

• Keyword Search: Find users by name, username, or topic.
• Automatic Pagination: Uses cursor-based pagination to collect multiple pages of results seamlessly.
• Comprehensive Data Extraction: Pulls detailed profile info including follower counts, verification status, bio, and more.
• Built-in Reliability: Includes configurable delays to respect rate limits and retry logic for error handling.
• Cost-Efficient: Operates on SociaVault's credit system with transparent pricing.

How to Use

1. Set the query input parameter to your search keyword (e.g., "fitness", "comedy").
2. Optionally, set maxUsers to limit the total number of profiles returned (1-500, defaults to 20).
3. Run the actor. It will handle pagination until it reaches the result limit.
4. Download the results in JSON, CSV, or Excel format from the dataset.

Input

Configure the actor using these input parameters.

Input Example:

{
  "query": "comedy",
  "maxUsers": 50
}

Output

The actor outputs an array of objects, each representing a TikTok user profile. Each object contains the following fields:

{
  "query": "comedy",
  "user_id": "12345678901234567890",
  "unique_id": "comedyking",
  "nickname": "Comedy King",
  "avatar_url": "https://p16-sign-sg.tiktokcdn.com/...",
  "follower_count": 1500000,
  "following_count": 234,
  "video_count": 567,
  "heart_count": 45000000,
  "verified": true,
  "bio": "Making people laugh daily ",
  "region": "US",
  "search_position": 1,
  "processed_at": "2024-12-20T10:30:00Z"
}

Data extracted includes:
* Basic Info: unique_id, nickname, avatar_url
* Statistics: follower_count, following_count, video_count, heart_count
* Profile Details: verified status, bio, region
* Metadata: user_id, search_position, processed_at timestamp

Built with ️ by SociaVault