300 ₽ на тесты после создания аккаунта

Number Lookup API

Умная проверка номеров для ваших сервисов

  • Методы для одного номера, для всей базы и для истории запросов

  • Массовая проверка — до 50 000 номеров за запрос

  • Прогноз на основе машинного обучения с точностью 93%

  • Оплата только за выполненные проверки

Что даёт проверка номеров

Сокращение инициаций вызовов

Дозванивайтесь с 1–2 попыток вместо 4–5

Экономия бюджета до 27%

Исключайте неактивные номера, чтобы не тратить ресурсы на звонки и SMS

Сегментация базы

Сегментируйте контакты по активности, оператору и региону, используя данные операторов связи

Подключение за один день

Вызывайте методы по REST API или загружайте CSV-файл в личном кабинете

Подробнее в документации

Смотреть

Не статус номера, а данные для решения

Не статус номера, а данные для решения

Обычный HLR-запрос отвечает на один вопрос — существует ли номер. Number Lookup API даёт больше информации:

Когда лучше связаться с абонентом

Насколько активен номер в среднем за последнее время. Коэффициент активности — прогноз по данным оператора, а не текущий статус абонента. Проверять базу перед каждой рассылкой не нужно

Какой оператор обслуживает номер и в каком регионе он зарегистрирован

Итог:вы получаете рекомендацию к действию, а не статус

Сценарии интеграции

Сценарий №1

Очистка базы перед рассылкой

Отправьте до 50 000 номеров через GenerateActivityScoreReport, получите результаты через GetHLRReport. Отправляйте SMS только на номера с коэффициентом активности выше заданного порога — не тратьте бюджет на неактивные номера.

Сценарий №2

Звонок в подходящее время

GetBestCallTime возвращает оптимальный период для звонка. Для всей базы используйте GenerateBestCallTimeReport — запланируйте звонки на этот период. GetLastDateActivity возвращает число дней с последней активности — отложите звонки на неактивные номера. Прогноз времени работает только по номерам МТС.

Сценарий №3

Выбор канала и маршрута

GetSimStatus проверяет регистрацию SIM-карты в сети за последние 24 часа — работает только по номерам МТС. GetBaseNumberInfo возвращает оператора, регион и признак переноса номера. Используйте эти данные для выбора канала связи и маршрута сообщения.

Методы для полной картины по номеру

Выбирайте методы под задачу и платите только за те, которые вызываете

Пример запроса

Один запрос — один номер

Методы принимают мобильный номер в формате 79999999999

POST https://api.exolve.ru/hlr/v1/GetSimStatus
Authorization: Bearer {api_key}

{
  "number": "79139999999"
}

Данные по одному номеру

GetActivityScore

Коэффициент активности номера от 0 до 1: чем выше значение, тем активнее абонент звонит, принимает звонки и обменивается сообщениями

GetSimStatus

Признак регистрации SIM-карты в сети оператора за последние 24 часа, работает только по номерам МТС

GetBestCallTime

Период времени в UTC+0, когда абонент вероятнее всего ответит на звонок, работает только по номерам МТС

GetBestSmsTime

Период времени в UTC+0, когда абонент вероятнее всего прочтёт SMS, работает только по номерам МТС

GetBaseNumberInfo

Регион регистрации SIM-карты, обслуживающий оператор и признак переноса номера между операторами

GetLastDateActivity

Количество дней с момента последней активности номера в сети

Как запустить проверку номеров

Один запрос — до 50 000 номеров. Результат приходит в отчёте

  1. Подготовьте CSV-файл и запишите номера в первую колонку в формате 79999999999
  2. Конвертируйте файл в base64 и передайте значение в запросе
  3. Получите идентификатор отчёта в ответе
  4. Запросите результаты методом GetHLRReport по этому идентификатору

Проверка 1 000 номеров занимает 3–5 минут.

50 000 номеров — до 1 часа 40 минут

Мы храним отчёты 30 дней

Проверка базы номеров

GenerateActivityScoreReport

Запрашивает оценку телеком-доступности для множества номеров и возвращает идентификатор отчёта

GenerateBestCallTimeReport

Запрашивает лучший период для звонка для множества номеров и возвращает идентификатор отчёта

GetHLRReport

Возвращает отчёт с результатами массовой проверки

GetHLRListReport

Возвращает список отчётов за выбранный период

Истории запросов — эти методы входят в Statistics API

GetHLRListActivityScore

История запросов оценки телеком-доступности

GetHLRListBestCallTime

История запросов лучшего времени для звонка

GetHLRListBestSmsTime

История запросов лучшего времени для SMS

GetHLRListBaseNumberInfo

История запросов базовой информации: регион SIM-карты, оператор, перенос номера

GetHLRListAggregation

Сводная история запросов оценки доступности и подходящего времени для контакта

Истории успеха наших клиентов

Подключение за пять шагов

  1. 1

    Создайте аккаунт

    Зарегистрируйтесь в МТС Exolve и получите 300 ₽ на тесты

  2. 2

    Создайте приложение

    Создайте приложение и скопируйте API-ключ в разделе «Ключи»

  3. 3

    Подключите услугу

    Активируйте «Умную проверку номеров» бесплатно

  4. 4

    Настройте авторизацию

    Передавайте ключ в заголовке Authorization как Bearer Token

  5. 5

    Отправьте первый запрос

    Выполните первый запрос, например GetActivityScore

Выберите удобный способ интеграции

в реальном времени

REST API

вызывайте методы для одного номера из своей системы и получайте ответ сразу

проверка больших списков

Массовая проверка через API

отправьте до 50 000 номеров одним запросом и заберите результаты по идентификатору отчёта

без кода

CSV-файл в личном кабинете

загрузите файл с номерами в разделе Проверка номеров без написания кода

CRM

Готовые интеграции с CRM

подключите проверку к своей CRM через API и обновляйте контакты автоматически

рассылка и обзвон

Вместе с другими API платформы

проверяйте номера перед отправкой через SMS API и перед обзвоном через Voice API

Платите за выполненные проверки

Стоимость зависит от метода и объёма запросов за месяц. Чем больше запросов к методу, тем ниже цена за каждый запрос. Запросы к разным методам не суммируются — степ-тарификация действует отдельно для каждого

  • Для звонков

    GetActivityScore, GetBestCallTime, GetLastDateActivity

  • Для сообщений

    GetBestSmsTime

  • Для любых каналов

    GetSimStatus, GetBaseNumberInfo

Оставьте заявку на подключение

Наш менеджер проконсультирует вас и поможет с выбором услуг

Вопросы и ответы

Обычный HLR-сервис отвечает только на вопрос, существует ли номер. Number Lookup API показывает, насколько номер активен, был ли он в сети за последние сутки и когда лучше позвонить или отправить SMS. Также сервис возвращает оператора и регион — вы получаете рекомендацию к действию на основе больших данных МТС.

Методы GetBaseNumberInfo, GetActivityScore и GetLastDateActivity работают по номерам всех популярных операторов России. Прогноз лучшего времени для звонка и SMS, а также статус регистрации SIM-карты работают только по номерам МТС.

Мы используем обезличенные данные оператора и модели машинного обучения. Точность прогнозов — 93%.

Да. Методы GenerateActivityScoreReport и GenerateBestCallTimeReport принимают до 50 000 номеров в одном запросе. Подготовьте CSV-файл, конвертируйте его в base64 и передайте в запросе. В ответе вы получите идентификатор отчёта — по нему метод GetHLRReport вернёт результаты. Остальные методы проверяют один номер за запрос. Файл с номерами также можно загрузить в личном кабинете.

Проверка 1 000 номеров занимает 3–5 минут, 50 000 номеров — до 1 часа 40 минут.

Мы храним результаты массовой проверки 30 дней. Список отчётов за нужный период вернёт метод GetHLRListReport.

Коэффициент активности — прогноз на основе больших данных, а не состояние номера в момент запроса. Поэтому проверять базу перед каждой рассылкой не нужно. Статус SIM-карты из метода GetSimStatus относится к последним 24 часам.

Используйте методы Statistics API: GetHLRListActivityScore, GetHLRListBestCallTime, GetHLRListBestSmsTime, GetHLRListBaseNumberInfo и GetHLRListAggregation. Укажите период, за который нужны данные.

Цена зависит от метода и объёма запросов за месяц. GetBaseNumberInfo стоит от 0,05 ₽ за запрос, GetActivityScore, GetBestCallTime и GetLastDateActivity — от 0,47 ₽, GetBestSmsTime и GetSimStatus — от 0,95 ₽. Вы платите только за выполненные проверки. Чем больше запросов к методу за месяц, тем ниже цена.

Да. Подключите услугу «Умная проверка номеров» в настройках приложения в личном кабинете. Это бесплатно, услуга заработает в течение пяти минут. Пока услуга не подключена, метод вернёт ошибку hlr is disabled on the application.

Создайте аккаунт в МТС Exolve — мы начислим 300 ₽ для тестирования. В тестовый период можно проверить только свой подтверждённый номер. Проверить номер без регистрации можно на демостенде на странице для бизнеса.

Нет, вы выбираете только те методы, которые нужны для ваших задач: для обзвона — GetActivityScore, GetBestCallTime, GetLastDateActivity; для SMS-рассылок — GetBestSmsTime. Не платите за лишнее.

Решения МТС Exolve