WhatsApp 批量号码检测 Deep API

检测全球手机号在 WhatsApp 上的人口统计与资料属性，包括性别、年龄及头像分析等。

API 地址

POST https://api.checknumber.ai/v1/tasks

主要功能

WhatsApp 批量号码检测 Deep API 提供强大的分析能力：

人口统计分析

API 从头像等资料中提取人口统计信息，包括：

性别识别
年龄估算
发色分析

资料属性

全面的资料信息，包括：

WhatsApp 账号状态验证
头像 URL 获取
头像类型分类
账号验证状态

批量处理

通过文件上传同时处理大量号码，适合大规模分析场景。

使用步骤

文件上传

上传包含 E.164 格式电话号码的文本文件：

请求示例

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file"' \
--form 'task_type="ws_avatar"'

请求参数

参数	类型	说明
`file`	`file`	待检测号码文件，每行一个号码
`task_type`	`string`	`ws_avatar` — 头像相关属性

状态查询

查询任务处理进度：

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

响应示例

创建任务响应

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

处理中状态响应

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

已完成任务响应

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

WhatsApp 号码检测结果字段

字段	说明	示例
`Number`	E.164 格式电话号码	+41798284651
`age`	基于头像估算的年龄区间	25
`avatar`	WhatsApp 头像 URL	https://checknumber.ai/avatar.jpg
`category`	头像类型分类	真人肖像、宠物头像、物体等
`gender`	从头像识别的性别	male, female
`hair_color`	从头像识别的发色	black, brown, blonde 等
`whatsapp`	号码是否有活跃 WhatsApp 账号	yes, no

API 响应体字段说明

字段	说明
`created_at`	任务创建时间戳
`updated_at`	任务状态最后更新时间
`task_id`	唯一任务标识
`status`	任务状态：pending / processing / completed / exported
`total`	处理的号码总数
`success`	成功识别的号码数
`failure`	处理失败的号码数
`result_url`	（可选）状态为 exported 时的结果下载地址

HTTP 状态码

状态	说明
`200`	`charge`，请求成功，任务已创建或状态已返回
`400`	`free`，错误请求，参数或文件格式无效
`500`	`free`，服务器内部错误，请稍后重试

集成注意事项

输入文件中每行应为一个 E.164 格式的电话号码。
使用返回的 task_id 轮询任务状态。
当状态为 exported 时，从 result_url 下载结果。
在应用中妥善处理不同状态码。

常见问题

1. API 的处理能力如何？

API 可高效处理大批量号码，并实时返回处理进度。

2. 输入文件应采用什么格式？

应为纯文本文件，每行一个 E.164 格式号码（例如 +41798284651）。

3. 人口统计分析的准确度如何？

人口统计信息基于对头像的 AI 处理，在可用时提供年龄、性别等属性的估算值。

4. API 响应中的状态码含义？

API 使用标准 HTTP 状态码表示成功或失败：

200：请求成功（计费）
400：参数或文件格式无效（不计费）
500：服务器内部错误（不计费）

5. API 如何定价？

价格为每 1 万条号码 6 美元。本 API 返回信息包括：

WhatsApp 账号状态验证
性别识别
年龄估算
头像类型分析
发色分析

更多定价及更大批量处理说明，请联系我们。