brightdata-tiktok
Discover TikTok influencers by keyword search using Bright Data API
When & Why to Use This Skill
This Claude skill automates the discovery of TikTok influencers and content creators by leveraging the Bright Data Web Scraping API. It enables users to perform targeted keyword searches to extract critical profile data—including follower counts, bios, and direct URLs—streamlining the process of influencer marketing, social media lead generation, and niche market analysis.
Use Cases
- Influencer Marketing: Identifying and vetting potential brand ambassadors or content creators in specific niches like 'fitness', 'beauty', or 'tech' for collaboration campaigns.
- Competitor & Market Research: Analyzing the landscape of active creators within a specific industry to understand audience reach and content trends on TikTok.
- Lead Generation: Building high-quality lists of TikTok profiles and contact information for marketing outreach, product seeding, or talent recruitment.
- Trend Monitoring: Searching for top-performing profiles associated with specific keywords to stay updated on viral content strategies and emerging social media influencers.
| name | brightdata-tiktok |
|---|---|
| description | Discover TikTok influencers by keyword search using Bright Data API |
Bright Data TikTok Scraper
Discover TikTok influencers using Bright Data's web scraping API.
When to Use
Use this skill when you need to:
- Find TikTok influencers in a specific niche
- Discover content creators for collaboration
- Search TikTok profiles by keyword
How to Use
Step 1: Trigger the Scrape
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/trigger-scrape.sh "search_keyword"
Parameters:
search_keyword: The keyword to search for (e.g., "fitness trainer", "cooking")
Returns: A snapshot_id used to fetch results
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/trigger-scrape.sh "fitness trainer"
# Output: snapshot_id=abc123xyz
Step 2: Wait for Scraping
Bright Data needs approximately 2-3 minutes to complete the scrape. Wait before fetching results.
Step 3: Fetch Results
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/get-snapshot.sh "snapshot_id"
Parameters:
snapshot_id: The ID returned from trigger-scrape.sh
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-tiktok/scripts/get-snapshot.sh "abc123xyz"
Output file: /tmp/data/tiktok_[timestamp].json
Output Data Structure
Each profile in the results includes:
| Field | Description |
|---|---|
profile_id |
Unique TikTok profile ID |
profile_username |
TikTok username (e.g., @username) |
profile_url |
Direct link to the profile |
profile_followers |
Number of followers |
description |
Profile/video description |
url |
Video URL |
Environment Variables
BRIGHTDATA_API_KEY: Required. Your Bright Data API key.
Guidelines
- Start with broad keywords, then narrow down if needed
- The API returns up to 5 profiles per search by default
- If the snapshot is not ready, wait and retry
- Always check for errors in the API response
Error Handling
| Error | Cause | Solution |
|---|---|---|
| "running" status | Snapshot still being prepared | Wait 1-2 minutes and retry |
| 401 error | Invalid API key | Verify BRIGHTDATA_API_KEY is set correctly |
| Empty results | No matches found | Try a different or broader keyword |