快速入门——首次查找个人资料只需 10 分钟
目标:向 WhatsApp 数据 API 发送单个经过身份验证的 HTTP 请求,并读取手机号码的公开个人资料。无需安装 SDK——支持任何语言的 HTTP 客户端。
步骤 1 — 获取 API 密钥
两个渠道——二选一。相同的 JSON 数据,相同的端点,不同的密钥来源和基本 URL:
| 渠道 | 基本 URL | 关键来源 | 必需的标头 |
|---|---|---|---|
| 直接代理 | https://whatsapp-proxy.checkleaked.cc | 直接购买。密钥在我们的控制面板中管理。 | x-rapidapi-key: <direct-key> |
| RapidAPI市场 | https://whatsapp-data1.p.rapidapi.com | RapidAPI 控制面板 → “应用” → 安全。在 RapidAPI 列表中订阅。 | x-rapidapi-key: <rapidapi-key>x-rapidapi-host: whatsapp-data1.p.rapidapi.com |
直接使用密钥无法访问 RapidAPI 基本 URL,反之亦然。为了兼容性,两者都重复使用了标头名称 x-rapidapi-key——关键在于值的来源。
第二步——提出你的第一个请求
直接代理(推荐):
curl -H "x-rapidapi-key: YOUR_DIRECT_KEY" \ "https://whatsapp-proxy.checkleaked.cc/number/13105551234"
RapidAPI市场:
curl -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \ -H "x-rapidapi-host: whatsapp-data1.p.rapidapi.com" \ "https://whatsapp-data1.p.rapidapi.com/number/13105551234"
步骤 3 — 阅读回复
回复内容为 WhatsAppEntry 文档(实际格式 - 已省略多余字段):
{
"number": "13105551234",
"countryCode": "US",
"phone": "+1 310 555 1234",
"type": "FIXED_LINE_OR_MOBILE",
"about": null,
"isWAContact": true,
"isUser": true,
"isBusiness": true,
"isGroup": false,
"isBlocked": false,
"isMyContact": false,
"isEnterprise": false,
"isVerified": false,
"id": {
"server": "c.us",
"user": "13105551234",
"_serialized": "[email protected]"
},
"businessProfile": {
"categories": [{ "id": "...", "localized_display_name": "Otra categoría" }],
"memberSinceText": "Se unió en abril, 2024.",
"isProfileLocked": true
},
"profilePic": { "success": false, "image_status": "item-not-found" },
"date": "2026-04-10T17:30:33.356Z",
"cached": true
}现场测试笔记:
- profilePic 是一个对象,而不是一个 URL。当图片存在时,通过 /picture/{number} 获取二进制文件;当图片不存在时,则获取 { success: false, image_status: "item-not-found" }。
- 当受到限制时,about 为空。
- isWAContact 是标准的“此号码是否在 WhatsApp 上”标志。
- 查找失败仍然会返回 WhatsAppEntry — 检查错误/存在字段,而不仅仅是 HTTP 状态。
第四步——处理错误
突发限制和身份验证错误返回的响应体很短:
{ "error": "Requests must be at least 0.5 seconds apart" }默认请求间隔:至少 500 毫秒(每秒 2 个请求)。MEGA 层级:250 毫秒(每秒 4 个请求)。完整错误参考。
/number/{number} 的可选查询标志
| 旗帜 | 影响 |
|---|---|
telegram=1 | 包含 Telegram 注册数据。 |
lookup=1 | 包含 TrueCaller 查询。 |
google=1 | 添加谷歌搜索结果摘要。 |
includeCarrier=1 | 请包含运营商/地区数据。 |
ignoreProfilePic=1 | 跳过获取头像(速度更快)。 |
forceBypassCache=1 | 强制重新查找(计为一次请求)。 |
fullAiReport=1 | 生成 AI OSINT 报告(响应时间较长)。 |
下一步
直接使用与RapidAPI的成本细分:请参见直接使用与RapidAPI的成本细分。
用户评价
来自满意客户的真实评价
4.5/5 (162 评论)