快速入门——首次查找个人资料只需 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.comRapidAPI 控制面板 → “应用” → 安全。在 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 报告(响应时间较长)。

下一步

用户评价

来自满意客户的真实评价

4.5/5 (162 评论)