WhatsApp Number Validator

Instantly verify if any phone number is registered on WhatsApp. This Apify Actor provides a simple, reliable way to validate WhatsApp numbers worldwide with a single API call.

---

🚀 Features

✅ Simple & Fast - Just provide a phone number and get instant validation
✅ Global Coverage - Works with phone numbers from any country
✅ Clean Results - Returns structured JSON data ready to use
✅ No Setup Required - No API keys or configuration needed
✅ Reliable - Powered by a dedicated validation service

---

📖 How to Use

Step 1: Provide Input

The actor accepts a single required parameter:

{
  "phoneNumber": "212612542343"
}

Important:

• Include the full country code (e.g., 1 for USA, 212 for Morocco)
• No spaces, hyphens, or special characters - just digits
• Example formats: 12125551234, 447700900123, 212612542343

---

Step 2: Run the Actor

Click the Run button in the Apify Console. The actor will:

1. Clean and format your phone number
2. Send a validation request to the verification service
3. Process the response
4. Store results in the Dataset

Typical runtime: 5-10 seconds

---

Step 3: Get Your Results

Access your results from the Dataset tab. Here's what you'll receive:

✅ Valid Number Example:

{
  "phoneNumber": "212612542343",
  "isValid": true,
  "exists": true,
  "timestamp": "2025-12-31T11:50:21.808482Z",
  "meta": {
    "instance": "RAPIDAPI",
    "source": "rapidapi",
    "timestamp": "2025-12-31T11:50:21.808482Z"
  },
  "status": "success"
}

❌ Invalid Number Example:

{
  "phoneNumber": "123456789",
  "isValid": false,
  "exists": false,
  "timestamp": "2025-12-31T11:51:14.206953Z",
  "meta": {
    "instance": "RAPIDAPI",
    "source": "rapidapi",
    "timestamp": "2025-12-31T11:51:14.206953Z"
  },
  "status": "success"
}

---

📊 Output Fields

Field	Type	Description
phoneNumber	string	The phone number you validated
isValid	boolean	true if the number is registered on WhatsApp
exists	boolean	Same as isValid (for compatibility)
timestamp	string	ISO 8601 timestamp when the check was performed
meta.instance	string	The validation service instance used
meta.source	string	The source of the validation
status	string	success for completed checks, or error message

---

💡 Use Cases

• Marketing Campaigns - Validate contact lists before WhatsApp campaigns
• Customer Verification - Confirm customers have active WhatsApp accounts
• Data Cleaning - Remove invalid numbers from your database
• CRM Integration - Verify numbers before adding to your CRM
• Lead Qualification - Check if leads are reachable on WhatsApp

---

🔌 Integration Examples

Using Apify API

// Node.js example
const { ApifyClient } = require("apify-client");

const client = new ApifyClient({
  token: "YOUR_APIFY_TOKEN",
});

const input = {
  phoneNumber: "212612542343",
};

const run = await client
  .actor("devscrapper/whatsapp-number-validator")
  .call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items[0].isValid); // true or false

Using curl

curl -X POST https://api.apify.com/v2/acts/devscrapper~whatsapp-number-validator/runs \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "212612542343"}'

Python Example

from apify_client import ApifyClient

client = ApifyClient('YOUR_APIFY_TOKEN')

run_input = {
    "phoneNumber": "212612542343"
}

run = client.actor('devscrapper/whatsapp-number-validator').call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Number {item['phoneNumber']} is {'valid' if item['isValid'] else 'invalid'}")

---

⚡ Pricing

This actor charges 1 compute unit per number checked, in addition to standard Apify compute time.

---

📌 Important Notes

• ✅ One phone number per actor run
• ✅ Results are automatically stored in the Dataset
• ✅ All phone numbers must include country code
• ✅ No rate limits (subject to Apify platform limits)
• ⚠️ Invalid/malformed numbers may return isValid: false

---

🛟 Support

Need help? Have questions?

• 📧 Contact support through the Apify platform
• 📖 Check the Apify documentation

---

📜 License

This actor is available for use on the Apify platform.