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 头像、年龄、性别分析
Telegram 用户名开通检测	`tg_username`	通过用户名检测 Telegram 是否开通
Telegram 用户名活跃检测	`tg_username_activity`	通过用户名获取 Telegram 用户 ID、最近上线时间、活跃天数与会员状态

API	task_type	说明
WhatsApp 检测	`ws`	批量 WhatsApp 注册检测
WhatsApp 商业号检测	`ws_business`	是否为 WhatsApp Business 商业账号
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/X 邮箱检测	`twitter_email`	Twitter/X 邮箱账户检测
Line 检测	`line`	Line 账户注册检测
Microsoft 检测	`microsoft`	Microsoft 手机号码账户检测
Band 检测	`band`	Band 账户注册检测
GoTo 检测	`goto`	GoTo 账户注册检测
Threads 检测	`threads`	Threads 账户注册检测
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 邮箱检测 + 画像补全（姓名/性别/职位/出生年/薪资/档案链接/手机号）
LinkedIn 用户名档案检测	`linkedin_username`	LinkedIn 公开档案检测 + 头像/姓名/公司/教育/经历 + 关联手机号/邮箱
Zalo 检测	`zalo`	Zalo 账户注册检测
Zalo 活跃天数检测	`zalo_active`	Zalo 活跃天数与最近在线时间
Zalo 性别年龄检测	`zalo_gender`	Zalo 账户画像（性别/年龄/头像）
Wheely 注册检测	`wheely`	Wheely 手机号注册检测
BongaCams 注册检测	`bongacams`	BongaCams 邮箱注册检测
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 邮箱账户检测
Crypto.com 检测	`crypto`	Crypto.com 已注册账户检测
Crypto.com 邮箱检测	`crypto_email`	Crypto.com 邮箱账户检测

号码与邮箱检测

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

API	task_type	说明
号码活跃检测	`active_check`	手机号码活跃度等级检测
高价值用户检测	`high_value_users`	根据手机号码的高价值用户信号检测
电商活跃号码检测	`ecom_active`	手机号近期是否在电商平台活跃
邮箱可投递性检测	`email_check` / `email_avatar`	检测邮箱是否有效且可正常收信。仅支持 Gmail、Yandex、Mail.ru、iCloud、Outlook 和 Yahoo。检测邮箱是否有公开头像并返回头像链接。仅支持 Gmail、Yandex 和 Mail.ru。

运营商检测

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

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

账户管理

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

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

产品目录

Product	Task type	Return fields
CheckNumber	`tg`	`number`, `activated`
Activity Checker	`tg_active`	`number`, `activated`, `uid`, `username`, `lastseen`, `activedays`, `member`
Profile Checker	`tg_avatar`	`Phone`, `activated`, `uid`, `username`, `Gender`, `Age`, `Ethnicity`, `Avatar`, `Last Online Time`, `Active Days`, `Is Member`, `first_name`, `last_name`

Product	Task type	Return fields
CheckNumber	`ws`	`number`, `activated`
Business Checker	`ws_business`	`number`, `whatsapp`, `business`
Activity Checker	`ws_active`	`number`, `activated`, `activetime`, `activedays`, `business`
Profile Checker	`ws_avatar`	`number`, `activated`, `age`, `avatar`, `category`, `gender`, `hair_color`, `number`, `skin_color`

CheckNumber

Product	Task type	Return fields
Validity Checker	`phoneCheck`	`number`, `activated`
Activity Checker	`active_check`	`number`, `activated`
High-Value Checker	`high_value_users`	`Mobile Number`, `Result`
E-commerce Checker	`ecom_active`	`number`, `activated`

Viber

Product	Task type	Return fields
CheckNumber	`viber`	`number`, `activated`
Activity Checker	`viber_active`	`number`, `activated`, `mid`, `last_online_time`, `active_days`
Profile Checker	`viber_senior`	`number`, `activated`, `last_online_time`, `active_days`, `mid`, `nickname`, `person_count`, `avatar_type`, `age`, `skin_color`, `gender`, `avatar`

iMessage

Product	Task type	Return fields
CheckNumber	`imessage`	`number`, `activated`

RCS

Product	Task type	Return fields
CheckNumber	`rcs`	`number`, `activated`, `system`

Signal

Product	Task type	Return fields
CheckNumber	`signal`	`number`, `activated`

VK

Product	Task type	Return fields
CheckNumber	`vk`	`number`, `activated`

Apple ID

Product	Task type	Return fields
CheckNumber	`apple`	`number`, `activated`
Email Checker	`apple_email`	`email`, `activated`

Facebook

Product	Task type	Return fields
CheckNumber	`facebook`	`number`, `activated`
Email Checker	`facebook_email`	`email`, `activated`

Amazon

Product	Task type	Return fields
CheckNumber	`amazon`	`number`, `activated`
Email Checker	`amazon_email`	`email`, `activated`

Instagram

Product	Task type	Return fields
CheckNumber	`instagram`	`number`, `activated`
Email Checker	`instagram_email`	`email`, `activated`

MAX

Product	Task type	Return fields
CheckNumber	`max`	`number`, `activated`
Profile Checker	`max_full`	`number`, `activated`

Netflix

Product	Task type	Return fields
CheckNumber	`netflix`	`number`, `activated`
Email Checker	`netflix_email`	`email`, `activated`

Line

Product	Task type	Return fields
CheckNumber	`line`	`number`, `activated`
Profile Checker	`line_senior`	`number`, `activated`

X (Twitter)

Product	Task type	Return fields
Email Checker	`twitter_email`	`email`, `activated`

Telegram (username)

Product	Task type	Return fields
Registration Checker	`tg_username`	`username`, `activated`, `avatar_url`
Activity Checker	`tg_username_activity`	`username`, `activated`, `uid`, `lastseen`, `activedays`, `member`, `avatar_url`

Product	Task type	Return fields
CheckNumber	`linkedin_phone`	`number`, `activated`
Email Checker	`linkedin`	`email`, `activated`
Email Profile Checker	`linkedin_profile`	`email`, `activated`, `first_name`, `last_name`, `gender`, `job_title`, `birth_year`, `inferred_salary`, `linkedin_url`, `phone`
Username Profile Checker	`linkedin_username`	`username`, `activated`, `phone`, `email`, `avatar`, `avatar_url`, `name`, `location`, `country`, `company`, `followers`, `about`, `languages`, `current_title`, `education`, `experience`

Zalo

Product	Task type	Return fields
CheckNumber	`zalo`	`number`, `activated`
Days Checker	`zalo_active`	`number`, `activated`, `uid`, `nickname`, `active_time`, `active_days`
Age & Gender Checker	`zalo_gender`	`number`, `activated`, `uid`, `nickname`, `gender`, `age`, `skin_color`, `avatar_type`, `person_count`, `avatar`

TikTok

Product	Task type	Return fields
CheckNumber	`tiktok`	`number`, `activated`, `username`, `uid`

Microsoft

Product	Task type	Return fields
CheckNumber	`microsoft`	`number`, `activated`

Snapchat

Product	Task type	Return fields
CheckNumber	`snapchat`	`number`, `activated`

Messenger

Product	Task type	Return fields
CheckNumber	`messenger`	`number`, `activated`

GoTo

Product	Task type	Return fields
CheckNumber	`goto`	`number`, `activated`

Threads

Product	Task type	Return fields
CheckNumber	`threads`	`number`, `activated`

Spotify

Product	Task type	Return fields
Email Checker	`spotify_email`	`email`, `activated`

Band

Product	Task type	Return fields
CheckNumber	`band`	`number`, `activated`

DHL

Product	Task type	Return fields
CheckNumber	`dhl`	`number`, `activated`

Sideline

Product	Task type	Return fields
CheckNumber	`sideline`	`Number`, `activated`

Airbnb

Product	Task type	Return fields
CheckNumber	`airbnb`	`number`, `activated`

Pornhub

Product	Task type	Return fields
Email Checker	`pornhub`	`email`, `activated`

Temu

Product	Task type	Return fields
CheckNumber	`temu`	`number`, `activated`

Botim

Product	Task type	Return fields
CheckNumber	`botim`	`number`, `activated`
Age & Gender Checker	`botim_gender`	`number`, `activated`, `gender`, `age`

Wheely

Product	Task type	Return fields
Registration Checker	`wheely`	`number`, `activated`

BongaCams

Product	Task type	Return fields
Registration Checker	`bongacams`	`email`, `activated`

RusDate

Product	Task type	Return fields
Registration Checker	`rusdate_email`	`email`, `activated`

Rabota.ru

Product	Task type	Return fields
Registration Checker	`rabota_phone`	`number`, `activated`

Exchange Registration Checkers

Binance

Product	Task type	Return fields
CheckNumber	`Binance`	`number`, `activated`
Email Checker	`binance_email`	`email`, `activated`

KuCoin

Product	Task type	Return fields
CheckNumber	`Kucoin`	`number`, `activated`
Email Checker	`kucoin_email`	`email`, `activated`

Htx

Product	Task type	Return fields
CheckNumber	`htx`	`number`, `activated`
Email Checker	`htx_email`	`email`, `activated`

CoinW

Product	Task type	Return fields
CheckNumber	`coinW`	`number`, `activated`
Email Checker	`coinw_email`	`email`, `activated`

Crypto.com

Product	Task type	Return fields
CheckNumber	`crypto`	`number`, `activated`
Email Checker	`crypto_email`	`email`, `activated`

OKX

Product	Task type	Return fields
CheckNumber	`okx`	`number`, `activated`

Email And Global Carrier Checkers

邮箱可投递性检测

Product	Task type	Return fields
可投递性检测	`email_check`	`email`, `activated`
头像检测	`email_avatar`	`email`, `activated`, `avatar`, `name`

Global Carrier Checker

Product	Task type	Return fields
Global Carrier Checker	`globalCarrier`	`number`, `number_type`, `country_code`, `carrier`, `underlying_carrier`, `region`, `city`

US Carrier Advanced

Product	Task type	Return fields
US Carrier Advanced	`us_carrier_premium`	`Number`, `number_type`, `carrier`, `city`

共享接口

API	Description
Global Phone Carrier Inquiry	Legacy synchronous single-number carrier lookup; not part of the 74-product catalog.
Balance Query API	Query available account balance.