WhatsApp 资料检测 · 批量

API 契约

两个调用就跑完一个任务

提交拿任务号，之后按任务号查询。任务成功时，查询响应里会带上结果文件的下载链接——没有第三个接口。

curl -X POST "https://walookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_profile_batch \
  -F file=@numbers.txt

curl "https://walookup.com/api/v1/bulk-tasks/123" -H "X-API-Key: sk_your_api_key"

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": 123,
    "product": "ws_profile_batch",
    "status": "success",
    "total": 2000,
    "success_cnt": 2000,
    "charged_amount_micros": 12000000,
    "result_url": "https://…/result.zip"
  }
}

结果字段

结果文件里有哪些列

下载的是一个 zip：除这张完整结果表外，还会把已注册与未注册的号码分成两份名单。

执行方式

一个批量任务是怎么跑完的

批量不是把实时检测放大 —— 它是一次提交、后台执行、稍后取件。整个过程你不需要守着页面，任务状态和结果都留在后台。

1. 上传号码文件一行一个号码的 .txt 或 .csv。文件流式提交，服务器不落盘保存。
2. 预检并预扣先校验格式与国家一致性，通过后按有效行数预扣余额；预检不过不扣一分钱。
3. 后台执行任务在后台跑，你可以关掉页面。失败会立即反馈并全额退款。
4. 下载结果文件完成后在批量检测页下载。只按实际返回结果的号码计费，差额自动退回。

适用场景

什么时候该用这一款

• 人群画像分层
• 名单细分投放
• 头像资产采集
• 账号真实性初筛

WhatsApp 资料检测（批量）返回该号码公开可见的资料字段：头像地址、头像类别、估计年龄段、性别与肤色等。适合需要对大名单做人群分层的场景。所有字段都来自账号公开可见的资料，不涉及聊天内容。

能力边界

这款产品不做什么

• 不做身份认证。结果只说明这个号码在平台上的公开状态，不能用来确认号码归属人。
• 不返回聊天记录、会话内容或任何私密账号内容。
• 提交任务时选定号码所属的国家/地区。名单应基本属于这一个国家——同拨号区的邻国号不算跨国，确属其它国家的号码超过 10% 会在扣费之前被拒绝。
• 结果反映任务执行那一刻的状态。需要最新状态就重新跑一次，我方不会自动刷新历史结果。
• 下载链接有时效。任务完成后请尽快下载，过期后可再次查询任务重新获取链接。

产品常见问题

关于资料检测

如何选择

实时检测还是批量检测

实时检测 · 查看价格

相关产品

其他批量产品