identifierНомер
+17253100591Номер в том виде, в каком его возвращает API, в формате E.164.
ОПРЕДЕЛЕНИЕ ОПЕРАТОРА НОМЕРА В РЕАЛЬНОМ ВРЕМЕНИ
Узнайте исходного оператора номера в реальном времени
Отправьте один номер, и в том же ответе придёт его исходное выделение: оператор, тип линии, страна и регион выделения. Изучите поля до интеграции.
0,001 $ за завершённый запросНеудачные и неопределённые запросы возвращаютсяБесплатный демо-запрос · без аккаунта
Определение оператора в реальном времени
Иллюстративный пример · не реальный запрос
Исходный операторT-Mobile
- Номер
- +17253100591
- Тип номера
- Fixed Line or Mobile
- Страна
- US
- Регион
- NV
- Город
- LAS VEGAS
ОДИН НОМЕР · ПОЛЕЗНЫЙ КОНТЕКСТ
Что возвращает определение оператора
Используйте возвращённые поля оператора, типа номера и местоположения, чтобы упорядочить записи о номерах телефонов.
POST /api/v1/check200 OKnumber_typeТип номера
Fixed Line or MobileТип линии в том виде, в каком его сообщает поставщик данных, — для номеров США обычно это «Fixed Line or Mobile», что не разделяет эти два типа.
country_codeКод страны
USДвухбуквенный код страны ISO.
carrierИсходный оператор
T-MobileОператор, которому номер был изначально выделен. Не текущий оператор после переноса.
regionРегион
NVРегион выделения — код штата или провинции. Может быть пустым.
cityГород
LAS VEGASГород выделения в написании поставщика; иногда это код телефонной станции, а не название места. Никогда не текущее местоположение.
Пустое необязательное поле не делает запрос недействительным.Описание полей →
СЦЕНАРИИ ИСПОЛЬЗОВАНИЯ
Где используются данные об операторах
Превращайте каждый завершённый запрос в практический контекст, который команда может использовать для сегментации, проверки и операций с данными клиентов.
Понимание выделения по сетям
Сравнивайте оператора, базового оператора и код страны для каждого номера, затем формируйте единые сегменты для маршрутизации, отчётности или подготовки к рассылкам.
T-Mobile · US→Сегмент сети
Упорядочивание записей номеров
Используйте number_type для сортировки списков контактов и приоритизации ручной проверки, не рассматривая его как признак доступности номера.
Fixed Line or Mobile→Контекст проверки
Обогащение процессов CRM
Сохраняйте нормализованный номер, оператора и метаданные линии рядом с существующей записью клиента, чтобы команды могли искать, проверять и повторно использовать один и тот же контекст.
+17253100591→Запись CRM
API ДЛЯ РАЗРАБОТЧИКОВ
Как вызвать API определения оператора в реальном времени
Изучите запрос для одного номера и типизированный ответ, затем вызовите тот же эндпоинт со своим ключом API.
Только исходное выделение. Без заявлений о текущем операторе, доступности или местоположении в реальном времени.
Документация APIcurl "https://carrierlookup.online/api/v1/check" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service_type":"carrier",
"identifier":"+17253100591"}'Цены
Цены на определение оператора
Платите за то, что проверяете, — подписка не обязательна. Один баланс покрывает все ваши проверки.
Постоянное пополнение
19,90 $
Зачисляется на баланс19,90 $
Баланс никогда не сгорает. Используйте его для всех продуктов в вашем аккаунте.
Все тарифы →30-дневные тарифы
9,90 $
Зачисляется на баланс10,40 $
Те же расходы — больше бонусного баланса. Продлевается каждые 30 дней.
Все тарифы →
Не только коды стран: почему глобальной маршрутизации SMS нужны данные о переносе номеров в реальном времениУзнайте, как данные о переносе номеров и метаданные о типе линии помогают процессам глобальной маршрутизации SMS и заменяют статические предположения о сети на основе префиксов.Читать статью
Работа с международными телефонными данными: почему маршрутизация по префиксам не работаетУзнайте, почему статическая маршрутизация по префиксам перестаёт работать при переносе номеров и что данные о выделении номера исходному оператору, получаемые при проверке международных номеров, могут и не могут вам сообщить.Читать статью
Почему перенос номеров в Мексике делает маршрутизацию по префиксам устаревшейУзнайте, почему перенос номеров в Мексике делает маршрутизацию по префиксам устаревшей и что данные определения исходного оператора могут и не могут дать для поддержания чистоты данных.Читать статью
Почему маршрутизация по префиксам не работает: влияние переноса номеров на глобальную доставку SMSУзнайте, почему перенос мобильных номеров делает маршрутизацию по префиксам устаревшей и как контекст выделения номера оператору поддерживает современные процессы глобальной доставки SMS.Читать статью
Как очистить данные CRM, чтобы снизить расходы на SMS и расширить охватОптимизируйте записи CRM с помощью очистки списков номеров телефонов. Используйте данные о выделении номера оператору и о типе линии, чтобы сократить напрасные расходы на SMS и точно направлять рассылки.Читать статью
Не только регулярные выражения: почему рабочим приложениям нужна проверка номеров с учётом метаданныхУзнайте о лучших практиках проверки номеров телефонов: переход от регулярных выражений к разбору с учётом метаданных, канонической нормализации в формат E.164 и контексту выделения номера оператору.Читать статьюFAQ
Вопросы об определении оператора
Ответы о данных оператора, балансе, доступе к API и неудачных запросах.
Как узнать, к какому оператору относится номер?
Отправьте один номер в формате E.164, и CarrierLookup вернёт в том же ответе сеть, которой он был изначально выделен, в виде полей верхнего уровня результата. Никаких очередей задач, опроса и обратных вызовов. На сам номер ничего не отправляется.
Определение оператора выполняется в реальном времени?
Запрос выполняется в реальном времени, а данные отражают исходное выделение — не путайте одно с другим. После отправки номера результат приходит в том же HTTP-ответе в виде полей верхнего уровня — без очереди задач, опроса и обратных вызовов. Возвращается сеть, которой изначально был выделен диапазон этого номера. Перенос номеров не учитывается, поэтому это не обязательно оператор, обслуживающий номер сегодня, и результат ничего не говорит о доступности номера. Панель, API для одного номера и синхронный API для нескольких номеров возвращают одни и те же поля.
Как списывается баланс?
Постоянный баланс покупается один раз и не продлевается. Баланс 30-дневного тарифа действует 30 дней с момента оплаты; неиспользованный остаток сгорает в конце текущего цикла. Тарифы автоматически продлеваются каждые 30 дней, пока вы не отключите автопродление. Отключение прекращает будущие списания; текущий тариф можно использовать до окончания срока. Средства за неудачные или неопределённые проверки возвращаются на соответствующий кошелёк.
Как получить 100 бесплатных проверок?
Создайте бесплатный аккаунт и обратитесь в поддержку за 100 бесплатными проверками — их можно использовать для любого продукта; пополнить баланс можно в любое время.
Какие способы оплаты поддерживаются?
Постоянное пополнение можно оплатить кредитной картой, другими поддерживаемыми картами или криптовалютой. 30-дневные тарифы оплачиваются картой на защищённой внешней странице оплаты и продлеваются каждые 30 дней. Оплата картой — без дополнительной комиссии. Для криптовалюты может взиматься комиссия за обслуживание, она показывается при оплате.
Как вызвать API CarrierLookup?
Создайте ключ API в настройках, затем вызовите /api/v1/check с заголовком X-API-Key, номером и service_type=carrier. Данные оператора вернутся в том же ответе JSON в виде полей верхнего уровня — carrier, underlying_carrier, number_type, country_code, region и city; несколько номеров можно отправить вместе через синхронный эндпоинт множественной проверки.
Означает ли результат с оператором, что номер активен и доступен?
Нет. Результат сообщает только сеть, которой номер был изначально выделен. Он не учитывает перенос номеров и не означает, что номер сейчас доступен. Перед тем как с кем-либо связаться, вы по-прежнему отвечаете за наличие согласия и соблюдение применимых правил.
Готовы протестировать процесс?