CheckNumber API - сервис проверки номеров телефонов

Добро пожаловать в CheckNumber API - ведущий сервис проверки и валидации номеров телефонов для разработчиков и компаний по всему миру.

Введение в API

CheckNumber предоставляет расширенные API для проверки номеров телефонов, которые позволяют массово валидировать номера более чем на 20 платформах. Проверяйте регистрацию в WhatsApp, обнаруживайте аккаунты в социальных сетях, сверяйте пользователей криптовалютных бирж или запрашивайте сведения об операторе связи - все это доступно в CheckNumber.

Типичные сценарии использования:

Очистка маркетинговых списков - удаляйте неактивные номера перед рассылкой кампаний
Предотвращение мошенничества - проверяйте номера, указанные пользователями при регистрации
Обогащение CRM - определяйте, какими платформами пользуются ваши контакты
KYC на криптовалютных биржах - сопоставляйте номера пользователей с регистрациями на биржах

Быстрый старт

1. Получите API-ключ

Зарегистрируйтесь на checknumber.ai и получите API-ключ в панели управления.

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-ключ в заголовке запроса:

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 Business	`ws_business`	Определяет бизнес-аккаунты WhatsApp
Проверка активности WhatsApp	`ws_active`	Дни с момента последнего входа и бизнес-статус
Проверка возраста и пола WhatsApp	`ws_avatar`	Анализ аватара, возраста, пола и цвета кожи
Валидация номера телефона	`phoneCheck`	Массовая проверка формата, действительности и нумерации

Другие платформы и электронная почта

API	task_type	Описание
Проверка Facebook	`facebook`	Проверка учетной записи Facebook
Проверка электронной почты Facebook	`facebook_email`	Проверка учетной записи Facebook по адресу электронной почты
Проверка профиля Facebook по ID/имени	`facebook_profile`	Проверка профиля Facebook по ID/имени + фото профиля/имя/описание/подписчики
Проверка Apple	`apple`	Проверка учетной записи Apple по номеру телефона
Проверка электронной почты Apple	`apple_email`	Проверка учетной записи Apple по адресу электронной почты
Проверка iMessage	`imessage`	Проверка активации iMessage (Apple)
Проверка RCS	`rcs`	Проверка поддержки RCS (Rich Communication Services)
Проверка Instagram	`instagram`	Проверка учетной записи Instagram
Проверка электронной почты Instagram	`instagram_email`	Проверка учетной записи Instagram по адресу электронной почты
Проверка профиля Instagram по ID/имени	`instagram_profile`	Проверка аккаунта Instagram по имени + фото лица/имя/публикации/подписчики/подписки
Проверка Amazon	`amazon`	Проверка учетной записи Amazon по номеру телефона
Проверка электронной почты Amazon	`amazon_email`	Проверка учетной записи Amazon по адресу электронной почты
Проверка электронной почты Twitter/X	`twitter_email`	Проверка аккаунта Twitter/X по электронной почте
Проверка LINE	`line`	Проверка регистрации учетной записи LINE
Проверка Microsoft	`microsoft`	Проверка учетной записи Microsoft по номеру телефона
Проверка Band	`band`	Проверка регистрации учетной записи Band
Проверка MAX	`max`	Проверка регистрации в мессенджере MAX
Проверка полного профиля MAX	`max_full`	Полный профиль MAX: имя, пол, последнее посещение и аватар
Проверка Viber	`viber`	Проверка регистрации учетной записи Viber
Проверка активности Viber	`viber_active`	Дни с момента последнего входа в Viber
Проверка Airbnb	`airbnb`	Проверка аккаунта Airbnb по номеру телефона
Проверка GoTo	`goto`	Проверка аккаунта GoTo
Проверка Threads	`threads`	Проверка аккаунта Threads
Проверка Signal	`signal`	Проверка аккаунта Signal
Проверка Snapchat	`snapchat`	Проверка аккаунта Snapchat
Проверка Messenger	`messenger`	Проверка аккаунта Messenger
Проверка электронной почты Netflix	`netflix_email`	Проверка аккаунта Netflix по электронной почте
Проверка Zalo	`zalo`	Проверка учетной записи Zalo
Проверка электронной почты Netflix	`netflix`	Проверка учетной записи Netflix по адресу электронной почты
Проверка электронной почты Spotify	`spotify_email`	Проверка учетной записи Spotify по адресу электронной почты

Определение регистрации на криптовалютных биржах

Сначала приведены проверки номеров телефонов на биржах, затем соответствующие проверки электронной почты.

API	task_type	Описание
Проверка Binance	`Binance`	Проверка зарегистрированной учетной записи Binance
Проверка электронной почты Binance	`binance_email`	Проверка учетной записи Binance по адресу электронной почты
Проверка KuCoin	`Kucoin`	Проверка зарегистрированной учетной записи KuCoin
Проверка CoinW	`coinW`	Проверка зарегистрированной учетной записи CoinW
Проверка HTX	`htx`	Проверка зарегистрированной учетной записи HTX (Huobi)
Проверка электронной почты KuCoin	`kucoin_email`	Проверка аккаунта KuCoin по электронной почте
Проверка электронной почты CoinW	`coinw_email`	Проверка аккаунта CoinW по электронной почте
Проверка электронной почты HTX	`htx_email`	Проверка аккаунта HTX по электронной почте
Проверка Crypto.com	`crypto`	Проверка зарегистрированной учетной записи Crypto.com
Проверка электронной почты Crypto.com	`crypto_email`	Проверка аккаунта Crypto.com по электронной почте

Проверка номеров и электронной почты

API	task_type	Описание
Проверка активности номера	`active_check`	Определение уровня активности номера телефона
Проверка пользователей с высокой ценностью	`high_value_users`	Определение признаков пользователей с высокой ценностью
Проверка активности e-commerce	`ecom_active`	Определение недавней активности в e-commerce по номеру
Проверка доставляемости почты	`email_check` / `email_avatar`	Проверяет, активны ли адреса электронной почты и могут ли они получать письма. Поддерживаются только Gmail, Yandex, Mail.ru, iCloud, Outlook и Yahoo. Проверяет наличие публичного аватара у адреса электронной почты и возвращает его URL. Поддерживаются только Gmail, Yandex и Mail.ru.

Определение оператора связи

Определяйте оператора связи и регион по номеру телефона.

API	task_type	Описание
Определение оператора связи	—	Поиск оператора связи, региона и типа номера

Управление учетной записью

Управляйте учетной записью 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`

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`

Shopee

Product	Task type	Return fields
CheckNumber	`shopee`	`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`

PayPal

Product	Task type	Return fields
CheckNumber	`paypal_number`	`number`, `activated`
Email Checker	`paypal_email`	`email`, `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`

Crypto Bot

Product	Task type	Return fields
Проверка электронной почты Crypto Bot	`cryptobot`	`email`, `activated`

ID/Username Checkers

Instagram

Product	Task type	Return fields
ID/Username Profile Checker	`instagram_profile`	`username`, `activated`, `avatar`, `visibility`, `ig_username`, `full_name`, `posts`, `followers`, `following`, `verified`

Facebook

Product	Task type	Return fields
ID/Username Profile Checker	`facebook_profile`	`username`, `activated`, `avatar`, `fb_id`, `fb_username`, `name`, `tagline`, `followers`, `talking_about`

Product	Task type	Return fields
Username Profile Checker	`linkedin_username`	`username`, `activated`, `phone`, `email`, `avatar`, `avatar_url`, `name`, `location`, `country`, `company`, `followers`, `about`, `languages`, `current_title`, `education`, `experience`

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.

CheckNumber API - сервис проверки номеров телефонов

Введение в API

Быстрый старт

1. Получите API-ключ

2. Отправьте пакетную задачу

3. Получите результаты

Обзор API

Аутентификация

Статус задачи

Справочник API

Платформы и электронная почта

Telegram

WhatsApp

Другие платформы и электронная почта

Определение регистрации на криптовалютных биржах

Проверка номеров и электронной почты

Определение оператора связи

Управление учетной записью

Каталог продуктов

Social Platform Registration Checkers

Telegram

WhatsApp

CheckNumber

Viber

iMessage

RCS

Signal

VK

Apple ID

Facebook

Amazon

Instagram

MAX

Netflix

Line

X (Twitter)

Telegram (username)

LinkedIn

Zalo

TikTok

Microsoft

Snapchat

Messenger

GoTo

Shopee

Threads

Spotify

Band

DHL

Sideline

Airbnb

Pornhub

Temu

Botim

Wheely

PayPal

BongaCams

RusDate

Rabota.ru

Exchange Registration Checkers

Binance

KuCoin

Htx

CoinW

Crypto.com

OKX

Crypto Bot

ID/Username Checkers

Instagram

Facebook

LinkedIn

Email And Global Carrier Checkers

Проверка доставляемости почты

Global Carrier Checker

US Carrier Advanced

Общие интерфейсы