WhatsApp批量号码检测头像（年龄和性别）API：个人资料分析和人口统计

检查输入的全球号码的WhatsApp头像信息，是否为whatsapp账户、个人资料图片URL、性别、年龄、发色、肤色以及个人资料图片的类型。

上传检测文件代码示例：

curl --location 'https://api.ekycpro.com/wa/api/deep/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"input.txt"'

检查任务状态代码示例：

curl --location 'https://api.ekycpro.com/wa/api/deep/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

上传检测文件成功的响应

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "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",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

提供任务完成的响应并包含结果下载URL。

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

上传文件请求URL

POST https://api.ekycpro.com/wa/api/deep/tasks

上传文件请求参数

参数	描述
user_id	string，用户ID
file	file，上传文件，每行应包含一个E.164格式的电话号码

检查任务状态请求URL

GET https://api.ekycpro.com/wa/api/deep/tasks/{TASK_ID}

检查任务状态请求参数

参数	描述
user_id	string，用户ID

结果字段

字段	描述	示例
Number	E.164格式的电话号码	+41798284651
age	基于个人资料图片的估计年龄范围	25
avatar	WhatsApp个人资料图片的URL	https://example.com/avatar.jpg
category	个人资料图片的类型分类	个人肖像、宠物头像、物体等
gender	从个人资料图片检测到的性别	male（男性）、female（女性）
hair_color	从个人资料图片检测到的发色	black（黑色）、brown（棕色）、blonde（金色）等
skin_color	从个人资料图片检测到的种族/肤色	white（白色）、black（黑色）等
whatsapp	号码是否有活动的WhatsApp账户	yes（是）、no（否）

响应格式

字段	描述
created_at	任务创建时的时间戳
updated_at	最后一次任务状态更新的时间戳
task_id	唯一任务标识符
user_id	用户ID
status	任务状态： pending：排队等待中 processing：当前正在处理 completed：处理完成 exported：结果可供下载
total	已处理的电话号码总数
success	成功识别的号码数量
failure	处理失败的号码数量
result_url	（可选）当状态为exported时的结果下载URL

状态码

状态码	描述
200	charge，请求成功，任务已创建或状态已检索
400	free，错误请求，参数或文件格式无效
500	free，内部服务器错误，请稍后重试