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	`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
Проверка Indiatimes	`indiatimes`	Проверка аккаунта Indiatimes
Проверка HT	`ht`	Проверка аккаунта HT
Проверка Cian	`cian`	Проверка аккаунта Cian
Проверка 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 по электронной почте
Проверка электронной почты Robinhood	`robinhood_email`	Проверка аккаунта Robinhood по электронной почте
Проверка электронной почты Crypto.com	`crypto_email`	Проверка аккаунта Crypto.com по электронной почте

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

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

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

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

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

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

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

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