Twitter/X Leads Scraper - Profile Email Finder

Turn X/Twitter into a contactable lead list. Give it search terms, hashtags, or @handles and get back unique author profiles — each with their email (from the bio and the linked website), follower count, verified status, a 0–100 lead score, and an optional AI cold-email opener. Export to CSV, JSON, or Excel.

Built for B2B cold email, creator/founder outreach, agencies, and recruiting — clean, scored, contactable data, not just a raw tweet dump.

---

Why this scraper

• 🧵 Tweets → unique authors — searches return tweets, but you want people. This actor collapses every matching tweet to one row per author handle (a two-pass roll-up), so you get profiles, not a noisy timeline.
• 📧 Two-source email finding — scans each author's bio for inline emails and visits their bio-link website (home / contact / about) to pull the real email + other socials.
• 🎯 Quality filters — min/max followers (target nano → macro tiers), verified-only, has-website, has-email. You only pay for leads you keep.
• 🧮 0–100 lead score — ranks by email + website + followers fit + verified + engagement (when available); best leads first.
• 🧹 Auto-dedupe — same handle / website / email collapses to one row.
• ✍️ AI cold-opener (optional) — a personalized one-line icebreaker per lead, written with your own OpenAI/Anthropic key.

---

Use cases

• Build an outreach list of founders / creators tweeting about your niche (search a topic, get their emails).
• Turn a hashtag (e.g. #buildinpublic) into a list of contactable builders.
• Pull a competitor's or community's handles into emails + CSV for your CRM.

---

Input

Provide at least one of searchTerms, hashtags, or handles.

{
  "searchTerms": ["ai founder", "shopify agency"],
  "hashtags": ["buildinpublic"],
  "handles": ["naval"],
  "maxItems": 200,
  "minFollowers": 1000,
  "onlyWithEmail": true,
  "enrichEmails": true,
  "writeOpeners": false
}

Field	What it does
searchTerms	Keywords / phrases to search X/Twitter for.
hashtags	Hashtags (with or without #); treated as extra search terms.
handles	Specific @handles or profile URLs to pull tweets from.
maxItems	How many tweets to scan before rolling up to unique authors.
minFollowers / maxFollowers	Target a follower band (0 = off).
onlyVerified	Keep only verified accounts.
onlyWithWebsite / onlyWithEmail	Keep only authors with a website / an email.
enrichEmails	Visit the bio-link site to find emails + socials (default on).
writeOpeners	Add an AI cold-opener per lead — needs your OpenAI/Anthropic key.

---

Output (one row per unique author, best leads first)

{
  "lead_score": 90,
  "handle": "somefounder",
  "name": "Some Founder",
  "bio": "Building an AI tool for agencies. Ex-Google. hello@somestartup.com",
  "followers": 24800,
  "email": "hello@somestartup.com",
  "email_status": "found",
  "website": "https://somestartup.com",
  "verified": true,
  "icebreaker": "Your take on AI tooling for agencies really resonated…",
  "profile_url": "https://x.com/somefounder"
}

Results render as a clean sortable table on the Output tab, and export to CSV / JSON / Excel.

---

How it works

1. Searches X/Twitter via apidojo/tweet-scraper for your terms / hashtags / handles.
2. Collapses the returned tweets to unique author profiles (dedupe by handle), averaging engagement across each author's tweets when that data is present.
3. Reads each bio for inline emails and visits the bio-link website for more.
4. Dedupes, applies your filters, and scores every lead 0–100.
5. (Optional) Writes a personalized cold-email opener per lead with your AI key.
6. Pushes a clean dataset → export CSV / JSON / Excel.

---

FAQ

Why authors instead of tweets? Search results are tweets, but for outreach you want the person. This actor rolls every matching tweet up to its author so you get a deduped list of contactable profiles.

Will every author have an email? No. X exposes a public email for very few profiles; the rest depend on what's in the bio or on the linked site. Use onlyWithEmail to keep just the contactable ones.

Do I need an API key? Only for AI openers, and it's your key (used once per run, never stored).

Is this legal? It scrapes public profile data. Use it for legitimate outreach and follow X's terms and anti-spam laws (CAN-SPAM / GDPR) in your messaging.