linkedin-influencer-discovery

# LinkedIn Influencer Discovery

Discover top LinkedIn influencers by topic, country, and follower count using the Apify `powerai/influencer-filter-api-scraper` actor. Queries a database of 3.6M+ influencer profiles filtered to those with LinkedIn presence.

## Quick Start

Requires `APIFY_API_TOKEN` env var (or `--token` flag). Install dependency: `pip install requests`.

```bash
# Find top AI influencers with LinkedIn profiles
python3 skills/linkedin-influencer-discovery/scripts/discover_influencers.py \
  --topic "artificial intelligence" --max-results 50 --output summary

# Find SaaS influencers in the US
python3 skills/linkedin-influencer-discovery/scripts/discover_influencers.py \
  --topic "saas" --country "United States of America" --output summary

# Find marketing influencers with email available
python3 skills/linkedin-influencer-discovery/scripts/discover_influencers.py \
  --topic "marketing" --has-email --max-results 100

# Filter to a specific follower range
python3 skills/linkedin-influencer-discovery/scripts/discover_influencers.py \
  --topic "fintech" --min-followers 10000 --max-followers 500000 --output summary
```

## CLI Reference

| Flag | Default | Description |
|------|---------|-------------|
| `--topic` | *required* | Topic to search (e.g. "artificial intelligence", "saas", "marketing") |
| `--category` | none | Category filter (e.g. "technology", "business", "lifestyle") |
| `--country` | none | Country (e.g. "United States of America", "United Kingdom") |
| `--language` | English | Language filter |
| `--min-followers` | 0 | Minimum follower count (client-side filter) |
| `--max-followers` | 0 (unlimited) | Maximum follower count (client-side filter) |
| `--has-email` | false | Only return influencers with an email address |
| `--max-results` | 100 | Max influencers to discover (up to 1000) |
| `--output` | json | Output format: `json` or `summary` |
| `--token` | env var | Apify token (prefer `APIFY_API_TOKEN` env var) |
| `--timeout` | 600 | Max seconds to wait for Apify run |

## Cost

~$0.01 per result. 100 influencers ~ $1.00. The script prints a cost estimate before running.

## Output Fields

Each influencer result includes (when available):
- `full_name` - Display name
- `username` - Social media handle
- `biography` - Bio text
- `follower_count` - Total followers (across platforms)
- `following_count` - Following count
- `main_topic` - Primary topic/niche
- `topics` - List of associated topics
- `category_name` - Category classification
- `linkedin_url` - LinkedIn profile URL
- `has_email` - Whether email is available
- `external_url` - Website URLs
- `country`, `city` - Location
- `is_verified` - Verification status

## Notes

- Results are sorted by follower count (descending) by default
- The actor queries a pre-indexed database, not live LinkedIn search
- Follower counts are across all platforms, not LinkedIn-specific
- The `--min-followers` and `--max-followers` flags filter client-side after results return
- For detailed profile enrichment, use the Apify `harvestapi/linkedin-profile-scraper` actor on the discovered LinkedIn URLs
- For post analysis, use the Apify `harvestapi/linkedin-profile-posts` actor on the discovered LinkedIn URLs