CheckNumber API - 手机号码验证服务

欢迎来到 CheckNumber API — 面向开发者和企业的手机号码验证服务，为全球开发者和企业提供解决方案。

API 简介

CheckNumber 提供先进的手机号码验证 API，帮助你批量验证 20+ 个平台上的手机号码。无论你需要验证 WhatsApp 注册、检测社交媒体账户、查询加密货币交易所用户，还是查询手机运营商信息，CheckNumber 都能帮助你。

典型应用场景：

营销名单清洗 — 发送活动前去除非活跃号码
欺诈防护 — 验证用户注册时提供的手机号码
CRM 数据丰富 — 识别联系人使用的平台
加密货币交易所 KYC — 交叉验证用户号码与交易所注册信息

快速开始

1. 获取 API Key

在 checknumber.ai 注册并从仪表盘获取 API Key。

2. 提交批量任务

上传 .txt 或 .csv 文件，每行一个手机号（E.164 格式，如 +8613800138000）：

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'

3. 轮询获取结果

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

当 status 变为 exported 时，从 result_url 下载结果文件。

API 概览

项目	详情
基础 URL	`https://api.checknumber.ai`
认证	`X-API-Key` 请求头
提交任务	`POST /v1/tasks`（multipart/form-data）
查询状态	`POST /v1/gettasks`（form-data）
查看余额	`GET /v1/balance`
文件格式	`.txt` 或 `.csv`，每行一个条目
最大批次大小	每个任务最多 1,000,000 条目

认证

所有请求都需要在请求头中传递 API Key：

X-API-Key: YOUR_API_KEY

任务状态

状态	含义
`pending`	任务已入队，等待开始
`processing`	任务正在处理
`exported`	结果已准备好，可从 `result_url` 下载

API 参考

产品分为平台与邮箱（混合）、加密货币交易所、号码与邮箱检测和运营商过滤四类。

平台与邮箱

按照营销网站顺序列出手机号和邮箱任务（Telegram → WhatsApp → … → Netflix / Spotify 邮箱）。

API	task_type	说明
Telegram 检测	`tg`	Telegram 账户注册检测
Telegram 活跃检测	`tg_active`	Telegram 最后在线天数
Telegram 头像检测	`tg_avatar`	Telegram 头像、年龄、性别分析

API	task_type	说明
WhatsApp 检测	`ws`	批量 WhatsApp 注册检测
WhatsApp 活跃检测	`ws_active`	最后在线天数、商业账户状态、个人签名
WhatsApp 头像检测	`ws_avatar`	头像、年龄、性别、肤色分析
手机号码验证	`phoneCheck`	批量格式/有效性/编号检测

更多平台与邮箱

API	task_type	说明
Facebook 检测	`facebook`	Facebook 账户验证
Facebook 邮箱检测	`facebook_email`	Facebook 邮箱账户检测
Apple 检测	`apple`	Apple 手机号码账户检测
Apple 邮箱检测	`apple_email`	Apple 邮箱账户检测
iMessage 检测	`imessage`	iMessage（Apple）激活检测
RCS 检测	`rcs`	RCS（富通信服务）支持检测
Instagram 检测	`instagram`	Instagram 账户验证
Instagram 邮箱检测	`instagram_email`	Instagram 邮箱账户检测
Amazon 检测	`amazon`	Amazon 手机号码账户检测
Amazon 邮箱检测	`amazon_email`	Amazon 邮箱账户检测
Airbnb 检测	`airbnb`	Airbnb 手机号码账户检测
Twitter 检测	`twitter`	Twitter 账户验证
Twitter/X 邮箱检测	`twitter_email`	Twitter/X 邮箱账户检测
Line 检测	`line`	Line 账户注册检测
Microsoft 检测	`microsoft`	Microsoft 手机号码账户检测
Band 检测	`band`	Band 账户注册检测
GoTo 检测	`goto`	GoTo 账户注册检测
Threads 检测	`threads`	Threads 账户注册检测
Indiatimes 检测	`indiatimes`	Indiatimes 账户注册检测
HT 检测	`ht`	HT 账户注册检测
Cian 检测	`cian`	Cian 账户注册检测
Signal 检测	`signal`	Signal 账户注册检测
Snapchat 检测	`snapchat`	Snapchat 账户注册检测
Messenger 检测	`messenger`	Messenger 账户注册检测
MAX 检测	`max`	MAX 消息应用注册检测
MAX 完整档案检测	`max_full`	MAX 消息应用完整档案（名称、性别、最后看见、头像）
Viber 检测	`viber`	Viber 账户注册检测
Viber 活跃检测	`viber_active`	Viber 最后在线天数
TikTok 检测	`tiktok`	TikTok 手机号账户检测
Viber 年龄性别检测	`viber_senior`	Viber 画像：年龄、性别、头像、活跃度
VK（VKontakte）检测	`vk`	VK 账户检测（仅俄罗斯）
Temu 检测	`temu`	Temu 账户注册检测
LinkedIn 号码检测	`linkedin_phone`	LinkedIn 手机号检测（美国与印度）
LinkedIn 邮箱检测	`linkedin`	LinkedIn 邮箱账户检测
Pornhub 邮箱检测	`pornhub`	Pornhub 邮箱账户检测
LinkedIn 邮箱画像检测	`linkedin_profile`	LinkedIn 邮箱检测 + 画像补全
Zalo 检测	`zalo`	Zalo 账户注册检测
Netflix 检测	`netflix`	Netflix 手机号码账户检测
Netflix 邮箱检测	`netflix_email`	Netflix 邮箱账户检测
Spotify 邮箱检测	`spotify_email`	Spotify 邮箱账户检测

加密货币交易所检测

先是交易所手机号检测，然后是各交易所邮箱检测。

API	task_type	说明
Binance 检测	`Binance`	Binance 已注册账户检测
Binance 邮箱检测	`binance_email`	Binance 邮箱账户检测
Kucoin 检测	`Kucoin`	KuCoin 已注册账户检测
KuCoin 邮箱检测	`kucoin_email`	KuCoin 邮箱账户检测
CoinW 检测	`coinW`	CoinW 已注册账户检测
CoinW 邮箱检测	`coinw_email`	CoinW 邮箱账户检测
HTX 检测	`htx`	HTX（Huobi）已注册账户检测
HTX 邮箱检测	`htx_email`	HTX 邮箱账户检测
Robinhood 邮箱检测	`robinhood_email`	Robinhood 邮箱账户检测
Crypto.com 邮箱检测	`crypto_email`	Crypto.com 邮箱账户检测

号码与邮箱检测

手机号码活跃度、高价值用户信号和邮箱有效性检测。

API	task_type	说明
号码活跃检测	`active_check`	手机号码活跃度等级检测
高价值用户检测	`high_value_users`	根据手机号码的高价值用户信号检测
邮箱检测	`email_check`	批量邮箱地址有效性检测

运营商检测

识别手机号码的运营商和地区信息。

API	task_type	说明
运营商查询（单号）	`usaCarrier`	同步单号运营商 / 号码类型查询
运营商批量查询	`usaCarrier` … `us_carrier_premium`	批量运营商、号码类型、国家及地区/城市

账户管理

管理你的 CheckNumber 账户和监控使用情况。

API	方法	说明
余额查询 API	`GET /v1/balance`	查询可用账户余额