WhatsApp Number Deep Detection API（深度检测）

WhatsApp 是广泛使用的即时通讯应用，了解 WhatsApp 账号详情对多种商业场景至关重要。本文介绍如何使用 WhatsApp 深度检测 API（含年龄与性别等）检测全球号码的 WhatsApp 账号状态与人口统计类详情。

主要功能

WhatsApp Number Deep Detection API 提供多项强大能力：

全面账号信息（年龄与性别等）

API 可提供 WhatsApp 账号的详细信息，包括注册状态、头像 URL、性别、年龄估算及头像类型（人口统计分析）等。

批量检测

可一次检测多个号码的状态与详情，非常适合批处理场景。

实时状态查询

可实时查询 WhatsApp 号码的当前状态，确保信息尽可能准确。

易于集成

API 设计便于集成，开发者可无缝接入现有系统。

使用步骤

使用 WhatsApp 深度检测 API 很简单，按以下步骤操作即可：

注册并获取 API Key。
使用 API Key 进行鉴权。
调用 API 检测 WhatsApp 号码详情。

示例代码

以下为使用 WhatsApp 深度检测 API（年龄与性别）的示例代码：

// WhatsApp avatar / age & gender — batch task_type ws_avatar
// Docs: https://docs.checknumber.ai/whatsapp-bulk-number-checker-avatar/

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('./numbers.txt'));
form.append('task_type', 'ws_avatar');

await axios.post('https://api.checknumber.ai/v1/tasks', form, {
  headers: { ...form.getHeaders(), 'X-API-Key': process.env.CHECKNUMBER_API_KEY },
});

// Then poll POST https://api.checknumber.ai/v1/gettasks with task_id until status is exported.

API 响应说明

API 返回 JSON，主要字段包括：

created_at：任务创建时间戳。
updated_at：任务状态最后更新时间戳。
task_id：任务唯一标识。
status：当前任务状态，可能取值包括：pending（排队中）、processing（处理中）、completed（处理完成）、exported（结果已处理并可下载）。
total：本任务处理的号码总数。
success：成功识别 WhatsApp 属性的号码数。
failure：无法识别或处理失败的号码数。
result_url：（可选）任务状态为 exported 时，用于下载结果的 URL。

常见问题

1. WhatsApp 深度检测 API 与 WhatsApp Number Detection API 有何区别？

WhatsApp 深度检测 API 比基础号码检测 API 更全面，除注册状态外，还可提供最后状态更新时间、是否为企业账号等更多信息。

2. 支持哪些国家/地区？

目前我们为全球超过 200 个国家与地区提供 WhatsApp 深度检测服务，覆盖世界各地。

3. WhatsApp 深度检测 API（年龄与性别）如何定价？

年龄与性别等检测按用量计费。当前费率与批量选项请见我们的定价页面或联系我们。

4. 免费用户每天最多可查询多少次？

免费用户每天约可查询 10～30 次。若需更高用量，请联系我们。