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

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

Введение в API

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

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

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

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

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

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

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

Загрузите файл .txt или .csv, где в каждой строке указан один номер телефона в формате E.164, например +8613800138000:

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

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

curl --location 'https://api.numberchecker.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.numberchecker.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	`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 (Rich Communication Services)
Проверка Instagram	`instagram`	Проверка учетной записи Instagram
Проверка электронной почты Instagram	`instagram_email`	Проверка учетной записи Instagram по адресу электронной почты
Проверка Amazon	`amazon`	Проверка учетной записи Amazon по номеру телефона
Проверка электронной почты Amazon	`amazon_email`	Проверка учетной записи Amazon по адресу электронной почты
Проверка Twitter	`twitter`	Проверка учетной записи Twitter
Проверка 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 по номеру телефона
Проверка электронной почты Twitter/X	`twitter_email`	Проверка аккаунта Twitter/X по электронной почте
Проверка 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_email`	Проверка аккаунта Crypto.com по электронной почте

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

API	task_type	Описание
Проверка активности номера	`active_check`	Определение уровня активности номера телефона
Проверка пользователей с высокой ценностью	`high_value_users`	Определение признаков пользователей с высокой ценностью
Проверка электронной почты	`email_check`	Массовая проверка адресов электронной почты

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

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

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

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

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

API	Метод	Описание
API запроса баланса	`GET /v1/balance`	Проверка доступного баланса учетной записи

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

Product	Task type	Return fields
NumberChecker	`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
NumberChecker	`ws`	`number`, `activated`
Activity Checker	`ws_active`	`number`, `activated`, `activetime`, `activedays`, `business`
Profile Checker	`ws_avatar`	`number`, `activated`, `age`, `avatar`, `category`, `gender`, `hair_color`, `number`, `skin_color`

NumberChecker

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`

Viber

Product	Task type	Return fields
NumberChecker	`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
NumberChecker	`imessage`	`number`, `activated`

RCS

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

Signal

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

VK

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

Apple ID

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

Facebook

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

Amazon

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

Instagram

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

MAX

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

Netflix

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

Line

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

X (Twitter)

Product	Task type	Return fields
NumberChecker	`twitter`	`number`, `activated`
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`
Profile Checker	`tg_username_profile`	`username`, `activated`, `avatar_url`, `uid`, `lastseen`, `activedays`, `member`, `category`, `gender`, `hair_color`, `skin_color`, `age`

Product	Task type	Return fields
NumberChecker	`linkedin_phone`	`number`, `activated`
Email Checker	`linkedin`	`email`, `activated`
Email Profile Checker	`linkedin_profile`	`email`, `activated`, `country`, `gender`, `industry`, `job_title`, `inferred_salary`

Zalo

Product	Task type	Return fields
NumberChecker	`zalo`	`number`, `activated`

TikTok

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

Microsoft

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

Snapchat

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

Messenger

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

GoTo

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

Threads

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

Spotify

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

Band

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

DHL

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

Sideline

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

Airbnb

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

Pornhub

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

Temu

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

Botim

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

Exchange Registration Checkers

Binance

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

KuCoin

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

Htx

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

CoinW

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

Crypto.com

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

OKX

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

Email And Global Carrier Checkers

Email Validation

Product	Task type	Return fields
Upload Task	`email_check`	`email`, `activated`

Global Carrier Checker

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

Advanced US Carrier Checker

Product	Task type	Return fields
Advanced US Carrier Checker	`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.