brightdata-instagram
Discover Instagram influencers by keyword search using Bright Data API
When & Why to Use This Skill
This Claude skill enables automated discovery of Instagram influencers and content creators by integrating with the Bright Data Web Scraping API. It streamlines the process of finding niche-specific profiles through keyword searches, providing essential data such as follower counts, biographies, and profile URLs to support data-driven marketing and outreach strategies.
Use Cases
- Influencer Marketing: Identify potential brand ambassadors and niche content creators by searching for specific industry keywords like 'fitness' or 'tech'.
- Market Research: Analyze the social media landscape and competitor presence within specific categories to understand audience engagement and profile trends.
- Lead Generation: Build targeted lists of social media leads with verified profile data for outreach, collaboration, or networking campaigns.
- Creative Asset Sourcing: Retrieve profile images and metadata to serve as references for AI-generated portraits or visual content planning.
| name | brightdata-instagram |
|---|---|
| description | Discover Instagram influencers by keyword search using Bright Data API |
Bright Data Instagram Scraper
Discover Instagram influencers using Bright Data's web scraping API.
When to Use
Use this skill when you need to:
- Find Instagram influencers in a specific niche
- Discover content creators for collaboration
- Search Instagram profiles by keyword
- Get influencer profile photos for portrait generation
How to Use
Step 1: Trigger the Scrape
$CLAUDE_CONFIG_DIR/skills/brightdata-instagram/scripts/trigger-scrape.sh "search_keyword"
Parameters:
search_keyword: The keyword to search for (e.g., "fitness", "photography")
Returns: A snapshot_id used to fetch results
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-instagram/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-instagram/scripts/get-snapshot.sh "snapshot_id"
Parameters:
snapshot_id: The ID returned from trigger-scrape.sh
Example:
$CLAUDE_CONFIG_DIR/skills/brightdata-instagram/scripts/get-snapshot.sh "abc123xyz"
Output file: /tmp/data/instagram_[timestamp].json
Output Data Structure
Each profile in the results includes:
| Field | Description |
|---|---|
username |
Instagram username |
url |
Direct link to the profile |
followers |
Number of followers |
biography |
Profile bio/description |
profile_pic_url |
URL to profile picture |
posts |
Array of recent posts with images |
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
- Profile photos can be downloaded for portrait generation
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 |