🔍 TikTok User Search Scraper

Search TikTok users and creators by keyword or name with comprehensive pagination support. Extract detailed user profiles including follower counts, verification status, profile information, and more.

🚀 Features

• Keyword Search: Find users by name, username, or related keywords
• Smart Pagination: Automatically handles cursor-based pagination for unlimited results
• Comprehensive Data: Extracts complete user profiles with statistics
• Rate Limiting: Built-in delays to respect API limits
• Error Handling: Robust error management and retry logic
• Cost Efficient: Uses SociaVault API with transparent credit pricing

📊 Data Extracted

Each user profile includes:

• Basic Info: Username, display name, unique ID, avatar URL
• Statistics: Follower count, following count, video count, like count
• Verification: Verified status and badges
• Profile Details: Bio description, profile picture, cover image
• Metadata: Account creation info, region, activity status
• Search Context: Relevance score and search query context

🔧 Input Parameters

Parameter	Type	Required	Default	Description
query	string	✅	-	Search keyword or name to find users
maxUsers	number	❌	20	Maximum number of users to extract (1-500)

📝 Input Example

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

🎯 Use Cases

• Influencer Discovery: Find creators in specific niches
• Competitor Research: Discover similar accounts in your industry
• Audience Analysis: Research user demographics and engagement
• Content Strategy: Identify trending creators for collaboration
• Market Research: Analyze creator landscape in different verticals

🔍 Example Search Queries

• "fitness" - Find fitness influencers and trainers
• "cooking" - Discover food creators and chefs
• "comedy" - Search for comedians and funny creators
• "business" - Find business and entrepreneurship accounts
• "travel" - Discover travel bloggers and destinations

📋 Output Format

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

🚦 Getting Started

1. Set Query: Enter your search keyword or user name
2. Configure Limits: Set maximum number of users to find
3. Run Scraper: Start extraction with automatic pagination
4. Download Results: Export data in JSON, CSV, or Excel format

📈 Performance

• Speed: ~20-30 users per request (1-2 seconds each)
• Accuracy: Real-time data directly from TikTok
• Reliability: Built-in retry logic and error handling
• Scalability: Handles searches from 1 to 500+ users

---

Built with ❤️ by SociaVault