WhatsApp Number Detail Detection API（详情检测）

WhatsApp 是广泛使用的即时通讯应用，了解 WhatsApp 账号详情对多种商业场景至关重要。本文介绍如何使用 WhatsApp 详情检测 API 查询账号状态与详细资料。

主要功能

WhatsApp 详情检测 API 提供多项强大能力：

全面账号详情

API 可提供 WhatsApp 账号的详细信息，包括注册状态、最后状态更新时间、是否为企业账号等。

实时状态查询

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

易于集成

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

使用步骤

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

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

示例代码

以下为使用 WhatsApp 详情检测 API 的示例代码：

// WhatsApp activity / signature fields — batch task_type ws_active
// Docs: https://docs.checknumber.ai/whatsapp-days-checker/

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_active');

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

// Then POST https://api.checknumber.ai/v1/gettasks with form field task_id until exported.

API 响应说明

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

number：被查询的 WhatsApp 电话号码。
whatsapp：关于该号码是否注册 WhatsApp 的结论，通常为字符串。
status_update：最后状态更新时间，帮助了解账号活跃程度。
signature：用户状态消息或个性签名（例如「Hey there! I am using WhatsApp」）。
avatar：若账号有头像，该字段为头像图片 URL。
region：与号码关联的地理区域，通常为国家或地区名称。
carrier：与号码关联的运营商信息。

常见问题

1. WhatsApp 详情检测 API 与 WhatsApp Number Detection API 有何区别？

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

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

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

3. WhatsApp 详情检测 API 如何定价？

价格为每 1 万条号码 2 美元，提供详细 WhatsApp 账号信息（与我们的批量 Details API 对齐）。批量最小起订量为 2000 条。单次查询或自定义量级请联系我们。

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

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