WA Lookup

接口约定

一次请求，立即返回

查看完整 API 文档 打开 API Key 页面

提交一个号码，并用 service_type 选择本产品；认证使用您的 API Key。

复制下面的 curl 命令，只需将示例 API Key 替换为您自己的 Key。

cURL 请求POST /api/v1/check
curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifier": "+17253100591" }'
响应200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+17253100591",
    "registered": true,
    "avatar": true,
    "avatar_url": "<image url>"
  }
}

使用方式

一次实时单号检测的三个步骤

  1. 提交一个号码

    请包含国家区号，例如 +17253100591，确保每次请求对应一个明确的号码。

  2. 读取所选产品字段

    当前 service_type 只返回其定义的 WhatsApp 字段；需要不同字段时请选择对应产品。

  3. 使用同步返回结果

    后端会同步返回所选字段；需要更新状态时请重新检测，联系用户前仍需取得相应同意。

产品常见问题

关于头像检测的常见问题

WhatsApp 头像检测 检测什么？

它对一个号码进行检测，并在同一次同步响应中返回注册状态、头像可用性和头像地址。

头像检测如何计费？

仅在检测完成后扣除余额；检测失败或无法判定的请求不会保留扣费。

需要提交什么？

提交一个 E.164 格式号码，需包含国家区号，例如 +17253100591。

显示已注册，是否代表获得了联系许可？

不是。结果仅反映检测时可获得的 WhatsApp 状态字段；同意、接收方偏好和适用的平台规则仍需由您自行遵守。

相关产品

其他 WhatsApp 检测产品

WhatsApp 注册检测确认号码是否已注册 WhatsApp，适合发送前检查联系人名单。WhatsApp 商业账号检测在确认 WhatsApp 注册状态的同时识别商业账号标记，帮助区分商业联系人。