Extract all contacts from any WhatsApp group in seconds — no apps, no extensions, just one script.
Perfect for marketers, community managers, and growth hackers who need contact lists from WhatsApp groups — fast.
Featured on: Product Hunt · DEV.to · Hacker News · DevHunt
A simple copy-paste JavaScript snippet that runs in your browser's developer console on WhatsApp Web. It automatically scrolls through a group's member list, extracts every contact, and downloads a clean .tsv file you can open in Excel, Google Sheets, or any spreadsheet app.
| Column | Description |
|---|---|
formatted_phone |
Phone number in international format (e.g. +2348012345678) |
is_my_contact |
Yes if saved in your contacts, No if unsaved |
saved_name |
The name you saved them as (if applicable) |
public_name |
Their WhatsApp display name / "About" name |
- A computer with a modern browser (Chrome, Edge, Firefox, Brave)
- Your WhatsApp account linked to WhatsApp Web
- You must be a member of the group you want to extract from
Step 1 → Open WhatsApp Web & connect your account
Step 2 → Open the group chat → Click the group name at the top
Step 3 → Click on the members section so the full member list panel opens
Step 4 → Press F12 to open Developer Tools → Click the "Console" tab
Step 5 → Type: allow pasting (and hit Enter — only if the browser asks)
Step 6 → Copy everything from whatsapp_extractor_v3.js, paste it into the console, hit Enter
Step 7 → Don't touch anything — let it run for 1–3 minutes
Step 8 → A .tsv file auto-downloads. Open it in Excel or Google Sheets. Done!
🍎 Mac Users: Use
Cmd + Option + J(Chrome) orCmd + Option + I(Firefox/Safari) to open the console instead of F12.
Open WhatsApp Web → click the group name → click on the members count to expand the full member list.
Press F12 → click the Console tab. If you see a warning about pasting, type allow pasting and press Enter.
Copy the entire contents of whatsapp_extractor_v3.js, paste it into the console, and press Enter.
You'll see real-time progress logs in the console:
🔍 STEP A: Finding the members scroll panel...
✅ Found the panel! (42 members visible, scrollHeight: 3200px)
🟢 You should see a GREEN border flash around the members list.
⏳ Auto-proceeding to extraction in 3 seconds...
🚀 EXTRACTING CONTACTS...
⏳ Phase 1: Scrolling to bottom to load all members...
Scrolling... loaded ~120 elements (scroll 0)
Scrolling... loaded ~340 elements (scroll 30)
📋 Phase 2: Extracting contacts (scrolling back up slowly)...
Extracted 156 contacts... (scroll 50)
Extracted 287 contacts... (scroll 100)
🎉 COMPLETE! Extracted 312 contacts
📥 File downloaded: whatsapp_group_contacts.tsv
📊 Summary:
Total contacts: 312
Your saved contacts: 89
Unsaved (phone only): 223
The downloaded whatsapp_group_contacts.tsv opens directly in Excel or Google Sheets. Each row is a contact with their phone number, name, and whether they're saved in your phone.
| formatted_phone | is_my_contact | saved_name | public_name |
|---|---|---|---|
| +2348012345678 | No | John D. | |
| +447911123456 | Yes | Alice Smith | Alice |
| +12025551234 | No | Marketing Pro | |
| +919876543210 | Yes | Raj Kumar | Raj |
- 📣 Marketing campaigns — Build targeted outreach lists from niche WhatsApp communities
- 🤝 Networking — Save contacts from professional groups and events
- 📋 Community management — Audit and track group membership
- 📈 Lead generation — Capture prospects from industry-specific groups
- 🗂️ CRM import — Export contacts directly into your CRM or mailing list
Is this safe to use?
Yes. The script runs entirely in your browser — no data is sent to any server. Everything stays on your computer. The code is open source, so you can read every line.
Will my WhatsApp account get banned?
This script simulates scrolling through the members list — something you can do manually. It doesn't use any unofficial APIs or modify WhatsApp's code. That said, use responsibly and avoid running it excessively in a short period.
Why is it downloading a .tsv instead of .csv?
TSV (Tab-Separated Values) handles phone numbers and international characters better than CSV. It opens perfectly in Excel and Google Sheets without any extra configuration.
The script says "Could not find the members panel"
Make sure the members list panel is fully open and visible on screen. Click the group name → click the members count → you should see a scrollable list of names/numbers.
It extracted 0 contacts
Try scrolling the members list manually once (up and down), then run the script again. This helps WhatsApp load the DOM elements the script looks for.
Can I use this on WhatsApp Desktop app?
No. This only works on WhatsApp Web in a browser. The desktop app doesn't expose a developer console the same way.
How large a group can it handle?
It has been tested on groups with 1000+ members. Larger groups just take longer to scroll through (3–5 minutes).
- ✅ 100% client-side — no data ever leaves your browser
- ✅ No tracking, no analytics, no telemetry
- ✅ Open source — audit every line of code yourself
⚠️ Respect privacy — only extract contacts from groups where you have legitimate access⚠️ Follow local laws — ensure your use complies with data protection regulations (GDPR, etc.)
Contributions are welcome! If you have ideas, bug fixes, or improvements:
- Fork this repository
- Create a feature branch (
git checkout -b feature/amazing-improvement) - Commit your changes (
git commit -m 'Add amazing improvement') - Push to the branch (
git push origin feature/amazing-improvement) - Open a Pull Request
This project is licensed under the MIT License — see the LICENSE file for details.
You are free to use, modify, and distribute this tool. No strings attached. 🎉
If this saved you time, drop a ⭐ — it helps others discover the tool!
Made with ☕ and curiosity.