跳转到内容

Twitter 号码检测 API

task_type=twitter

输入与数量限制

包含国家码的国际电话号码. 上传文本文件，每行一个值。只处理你有权检测的标识符。 电话号码必须包含国家码，建议使用 E.164 格式。

最低上传数量：1。最高上传数量：10,000,000。最低计费数量：500。最低上传数量与最低计费数量不同；较小的有效上传仍可能按最低计费数量收费。0 表示没有计费下限。完全失败或未处理的任务不会凭空按最低数量计费。提交前请查看账户当前价格。

创建任务

Terminal window
curl --request POST 'https://api.numberchecker.ai/v1/tasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'file=@input.txt' \
  --form 'task_type=twitter'

轮询与下载

保存返回的 task_id。轮询至 status=exported 后下载 result_url。pending 和 processing 表示尚未完成，failed 表示失败。创建请求超时后不要自动重交，原请求可能已成功创建任务。

Terminal window
curl --request POST 'https://api.numberchecker.ai/v1/gettasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'task_id=YOUR_TASK_ID'

CSV 字段

number,activated

保留列顺序和大小写。空值或无法确定的结果不等于明确的否定结果。

认证与错误处理

通过 X-API-Key 请求头传递服务端密钥。400：输入无效；401：密钥无效；402：余额不足；404：任务不存在；413：文件过大。状态查询可采用有上限的退避重试，并保留原任务 ID。

当前价格

契约核验日期：2026-10-30。数量限制可能变化，请在提交前查看控制台。