WhatsApp Number Validator PRO 数据集概述
基本信息
- 数据集名称：WhatsApp Number Validator PRO
- 提供者：Nulleye API
- 类别：Communication
- API版本：v1 (current)
- 基础URL：https://rapidapi.com/nulleye/api/whatsapp-number-validator-pro
功能描述
WhatsApp Number Validator PRO 是一个可靠且经济高效的API，用于检查电话号码是否在WhatsApp上注册。它支持单号码和批量验证，可检测WhatsApp Business账户，并在可用时获取公开个人资料信息。
端点概览
| 端点 |
方法 |
描述 |
/single |
GET |
验证单个WhatsApp号码 |
/bulk |
GET |
验证多个WhatsApp号码 |
1. 单号码验证
端点
GET /single?number=PHONE_NUMBER
参数
| 名称 |
类型 |
必需 |
描述 |
number |
string |
✅ |
国际格式的电话号码（不要使用 +） |
示例响应
json
{
"number": "919022690609",
"valid": true,
"isBusiness": true,
"isEnterprise": false,
"profilePicUrl": "https://pps.whatsapp.net/...",
"profilePicStatus": "ok"
}
2. 批量号码验证
端点
GET /bulk?number=PHONE1,PHONE2,PHONE3（号码间用逗号、空格或换行分隔）
参数
| 名称 |
类型 |
必需 |
描述 |
number |
string |
✅ |
以逗号、空格或换行分隔的电话号码（不要使用 +） |
示例响应
json
{
"count": 3,
"tookMs": 612,
"results": [
{
"number": "919022690609",
"valid": true,
"isBusiness": true,
"isEnterprise": false,
"profilePicUrl": "https://pps.whatsapp.net/...",
"profilePicStatus": "ok"
},
{
"number": "6281234567890",
"valid": true,
"isBusiness": false,
"isEnterprise": false,
"profilePicUrl": null,
"profilePicStatus": "unavailable"
},
{
"number": "447700900123",
"valid": false,
"isBusiness": null,
"isEnterprise": null,
"profilePicUrl": null,
"profilePicStatus": "not_registered"
}
]
}
响应字段说明
单/批量结果通用字段
| 字段 |
类型 |
描述 |
| number |
string |
规范化的电话号码（仅数字） |
| valid |
boolean |
指示该号码是否在WhatsApp上注册 |
| isBusiness |
boolean |
null |
| isEnterprise |
boolean |
null |
| profilePicUrl |
string |
null |
| profilePicStatus |
string |
个人资料图片获取状态 |
批量响应特有字段
| 字段 |
类型 |
描述 |
| count |
number |
处理的总号码数 |
| tookMs |
number |
处理时间（毫秒） |
| results |
array |
验证结果列表 |
profilePicStatus 状态值
| 值 |
含义 |
| ok |
个人资料图片可用 |
| unavailable |
因隐私设置隐藏或无个人资料图片 |
| error |
获取失败（网络问题或限制） |
| not_registered |
电话号码未在WhatsApp注册 |
| missing_number |
缺少号码参数 |
| invalid_number |
电话号码格式无效 |
| contact_unavailable |
无法检索联系人数据 |
速率限制
- 每个批量请求最多 200个号码。
- 建议请求间隔：150–300毫秒。
- 过多请求可能触发临时限制。
错误响应
| HTTP 状态码 |
含义 |
| 400 |
错误请求（缺少或参数无效） |
| 429 |
请求过多（超出速率限制） |
| 503 |
WhatsApp客户端未就绪 |
| 500 |
内部服务器错误 |
注意事项与限制
- 个人资料图片URL是临时的，可能会过期。
- 姓名、关于信息和商业资料详情取决于用户的隐私设置。
- 无法访问用户位置、最后上线时间、在线状态和IP地址。
- 此API执行只读验证（无消息传递或交互）。
最佳实践
- 在使用其他字段之前，始终检查
valid === true。
- 不要依赖
profilePicUrl 一定可用。
- 对大型数据集使用批量端点以减少开销。
- 对重复检查实施本地缓存。
免责声明
此API依赖于WhatsApp Web的行为，并受WhatsApp隐私政策和限制的约束。数据的可用性可能因账户、地区和隐私设置而异。
