Whatsapp Profile Scraper

Retrieve available WhatsApp profile information for a phone number.

The Actor can return profile-picture information and, when available, WhatsApp Business profile details including address, description, website, email, category, timezone, and business hours.

🚀 NEED BULK VALIDATION? Visit https://apifactory.pro/whatsapp-number-validator.aspx

Features

• Retrieve available WhatsApp profile data
• Retrieve profile picture when visible
• Detect available WhatsApp Business profile information
• Retrieve business description
• Retrieve business address
• Retrieve business website
• Retrieve business email
• Retrieve business category
• Retrieve business hours and timezone
• Fast real-time API through Apify Standby
• Simple JSON request and response
• Suitable for CRM enrichment and automated workflows

Profile lookup

Use the /profile endpoint.

Endpoint

POST /profile

Request

{
  "phone_number": "447984004914"
}

Phone numbers should be provided in international format. The leading + is optional.

Example response

{
  "phone": "+447984004914",
  "success": true,
  "contactId": "447984004914@s.whatsapp.net",
  "picture": "https://example.com/profile-picture.jpg",
  "businessProfile": true,
  "businessWid": "447984004914@s.whatsapp.net",
  "businessAddress": "London, United Kingdom",
  "businessDescription": "Example business description",
  "businessWebsite": "https://example.com",
  "businessEmail": "hello@example.com",
  "businessCategory": "Professional Services",
  "businessTimezone": "Europe/London",
  "businessHours": null,
  "status": "success",
  "message": "Success"
}

Not every field will be available for every profile.

For a normal WhatsApp account, a response may instead look like:

{
  "phone": "+447984004914",
  "success": true,
  "contactId": "447984004914@s.whatsapp.net",
  "picture": null,
  "businessProfile": false,
  "businessWid": null,
  "businessAddress": null,
  "businessDescription": null,
  "businessWebsite": null,
  "businessEmail": null,
  "businessCategory": null,
  "businessTimezone": null,
  "businessHours": null,
  "status": "success",
  "message": "Success"
}

Calling the API

This Actor supports Apify Standby, allowing it to behave like a real-time API.

cURL example

curl -X POST \
  "https://api-factory--whatsapp-profile-scraper.apify.actor/profile" \
  -H "Authorization: Bearer YOUR_APIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "447984004914"
  }'

Replace YOUR_APIFY_API_TOKEN with your Apify API token.

You can also explore and test the API through the Actor's Endpoints tab in Apify.

Running from the Apify Console

The Actor can also be run normally from the Apify Console.

Enter:

447984004914

and start the Actor.

The available profile information will be written to the Actor dataset.

Response fields

Field	Description
phone	Normalized phone number
success	Whether the profile lookup completed successfully
contactId	WhatsApp contact identifier returned by the lookup
picture	Profile-picture URL when available
businessProfile	Whether WhatsApp Business profile information was returned
businessWid	Business WhatsApp identifier when available
businessAddress	Business address when available
businessDescription	Business profile description when available
businessWebsite	Business website when available
businessEmail	Business email address when available
businessCategory	WhatsApp Business category when available
businessTimezone	Business timezone when available
businessHours	Business opening-hours information when available
status	Status returned by the profile lookup
message	Additional status information

Important: profile visibility

A null value does not necessarily mean that the information does not exist.

For example:

{
  "picture": null
}

can occur because:

• The account has no profile picture
• The profile picture is not visible to the WhatsApp session performing the lookup
• The user's privacy settings restrict profile-picture visibility
• WhatsApp does not return the information for that lookup

The same principle applies to other profile fields.

Does this Actor confirm whether a number is registered on WhatsApp?

Not necessarily.

A successful profile lookup containing a WhatsApp-style contactId should not by itself be treated as definitive proof that the number is registered.

Likewise:

{
  "picture": null
}

does not mean the number is unregistered.

If you specifically need to determine whether a number is registered on WhatsApp, use the WhatsApp Number Validator Actor instead.

The two Actors are designed for different purposes:

Actor	Purpose
WhatsApp Number Validator	Determine whether a number is registered on WhatsApp
WhatsApp Profile Scraper	Retrieve available profile and business information

Pricing

This Actor uses pay-per-result pricing.

Each successful profile lookup counts as one result.

See the Actor's current Apify pricing section for the latest price per result.

Free Apify accounts may be subject to additional usage limits.

Common use cases

• CRM enrichment
• WhatsApp contact enrichment
• Business-profile discovery
• Retrieving available profile pictures
• Lead enrichment
• Customer-data verification
• Business-contact research
• Make, Zapier, n8n, and custom API workflows

Input format

Use an international phone number including the country code.

Examples:

447984004914
+447984004914
14155552671
5511999999999

Data availability

The Actor returns only information made available by the underlying WhatsApp profile lookup at the time of the request.

Results may vary depending on:

• WhatsApp privacy settings
• Account type
• Profile visibility
• Whether the account uses WhatsApp Business
• Changes made by the WhatsApp user

Support

If you encounter an issue, please open an issue through the Actor's Apify page and provide:

• The HTTP status code
• The response received
• The endpoint used
• A sample phone number where appropriate

Never include your Apify API token or other credentials in a public support request.