A lightweight tool that retrieves WhatsApp profile information using only a phone number, returning clean, structured data ready for integration. It helps developers and analysts quickly verify profile presence, status text, and profile images without manual checks.
Created by Bitbash, built to showcase our approach to Scraping and Automation!
If you are looking for whatsapp-scraper-profile-by-number you've just found your team — Let’s Chat. 👆👆
This project fetches publicly available WhatsApp profile details associated with a phone number and normalizes them into a developer-friendly JSON response. It solves the problem of manually checking profile metadata and image availability, and is designed for developers, growth teams, and data workflows that need fast profile lookups.
- Validates international phone numbers before processing
- Retrieves profile name, status text, and business flag
- Downloads and converts profile pictures into Base64 format
- Returns consistent JSON for APIs, pipelines, and storage
| Feature | Description |
|---|---|
| Phone number validation | Ensures only valid numbers are processed to avoid errors. |
| Profile metadata extraction | Retrieves name, about/status text, and business indicator. |
| Base64 image conversion | Converts profile pictures into raw Base64 for easy embedding. |
| Multiple output formats | Supports detailed API output and simplified array responses. |
| Ready-to-integrate JSON | Normalized structure suitable for databases and services. |
| Field Name | Field Description |
|---|---|
| phone | The normalized WhatsApp phone number queried. |
| about | Profile “about” or status text if available. |
| is_business | Indicates whether the account is a business profile. |
| picture_url | Direct URL to the profile image when available. |
| base64_image | Profile picture encoded in Base64 without prefix. |
| image_size | Size of the downloaded profile image in bytes. |
| download_success | Indicates whether image retrieval succeeded. |
| timestamp | Time when the lookup was performed. |
[
{
"phone": "5579999393233",
"about": "Hey there! I am using WhatsApp.",
"is_business": false,
"picture_url": "https://example.com/profile.jpg",
"base64_image": "iVBORw0KGgoAAAANSUhEUgAA...",
"image_size": 84478,
"download_success": true
}
]
Whatsapp Scraper Profile By Number/
├── src/
│ ├── main.js
│ ├── services/
│ │ ├── validator.js
│ │ ├── profileFetcher.js
│ │ └── imageConverter.js
│ ├── utils/
│ │ └── normalizer.js
│ └── config/
│ └── settings.example.json
├── data/
│ └── sample-output.json
├── package.json
└── README.md
- Developers use it to verify WhatsApp profiles by number, so they can automate user validation workflows.
- Growth teams use it to enrich contact lists, so they can segment users more accurately.
- CRM integrations use it to attach profile images and status text, so records stay complete and up to date.
- Analysts use it to study account types, so they can distinguish business and personal profiles.
Does this require WhatsApp login credentials? No credentials are required; the tool works solely with a provided phone number.
What image format is returned? Profile pictures are returned as raw Base64 strings without any data URI prefix.
Is business account detection supported? Yes, the output includes a clear indicator showing whether the profile is a business account.
Can I choose a simplified response format? Yes, a compact array-based output is available for lightweight integrations.
Primary Metric: Average lookup completes in under 2 seconds per phone number.
Reliability Metric: Over 98% successful responses on valid numbers in stable network conditions.
Efficiency Metric: Minimal resource usage with single-request processing per lookup.
Quality Metric: High data completeness, with profile metadata returned whenever publicly available.
