Собираем несколько сигналов
Номер сопоставляется с пятью репутационными источниками. В ответе виден результат каждого, где есть данные.
ОКЗвонок сверяет номер с пятью базами определителей и возвращает один объяснимый ответ: активные метки, score, категории — и был ли номер в спаме раньше, даже если потом «обелился».
80
score / 100
Негативный сигнал найден в 2 из 4 источников, где есть данные. Итоговый score — 80 из 100.
так выглядит поток ответов · демо-данные
Данные индекса на 12 ноября в 16:28 МСК. В индекс попадают все номера с доступным сигналом, не только спам.
Один источник может не знать номер, а один флаг «спам / не спам» не объясняет решение. ОКЗвонок сводит сигналы определителей в общий score и показывает вклад каждого.
1пять баз проверяют номер
80score / 100
Номер сопоставляется с пятью репутационными источниками. В ответе виден результат каждого, где есть данные.
Единый score 0–100 складывается из весов источников с негативной меткой. Плюс категория, confidence и список источников.
Если данных недостаточно, API честно возвращает unknown — без ложного обещания, что номер безопасен.
Обычная проверка видит только состояние «сейчас». ОКЗвонок сохраняет факт снятия метки: по какому источнику номер считался спамом, к какой категории относился и когда метка исчезла.
Когда источник удаляет спам-метку, информация не исчезает бесследно из вашего ответа.
Два номера могут быть «чистыми» сейчас, но только у одного недавно менялась репутация.
previously_spam не делает номер плохим автоматически. Это дополнительный признак для вашего правила.
репутация номера во времени
+7 ••• •••-18-02
12 мая
Метка «Реклама и услуги»
14 сентября
Метка снята источником
Сегодня
verdict: ok + previously_spam
"verdict": "ok",
"previously_spam": {
"yandex": {
"category": "Реклама и услуги",
"removed_at": "2026-09-14"
}
}Номер может стать чистым. Его репутационная история не должна исчезать вместе с меткой.
Сохраните результат в карточке контакта, добавьте в модель риска или выберите маршрут звонка. Не нужно разбирать пять разных форматов ответа.
curl -X POST "https://api.okzvonok.ru/v1/unified-spam-check" \
-H "X-API-Key: okz_..." \
-H "Content-Type: application/json" \
-d '{"number":"+79991234567","mode":"offline"}'
{
"number": "79991234567",
"is_spam": true,
"score": 80,
"confidence": "high",
"verdict": "spam",
"sources": {
"yandex": { "is_spam": true, "category": "Реклама и услуги" },
"kaspersky": { "is_spam": false },
"mts": { "is_spam": true, "category": "Реклама" }
},
"previously_spam": null,
"operator": "МТС",
"region": "Москва",
"billed_as": "offline"
}
POST /unified-spam-check
один номер
POST /bulk-spam-check
до 1000 номеров
GET /lookup
оператор и регион
Формат ответа одинаковый. Меняется способ получения сигнала и единица списания — она видна в каждом ответе в поле billed_as.
Проверка по объединённому индексу без внешних запросов во время выполнения.
Офлайн-индекс и живой онлайн-запрос по каждому номеру в одном ответе.
Свежий онлайн-сигнал по номеру. При сбое источника вернётся офлайн-результат с явной отметкой.
Практичный сценарий: сначала проверить список в Offline, затем отправить в Online только номера со статусом unknown или высокой ценностью.
До 1000 номеров одним запросом или файлом в кабинете — с экспортом результата в CSV.
Проверяйте собственный пул по расписанию и ловите новые метки раньше, чем упадёт дозвон.
Репутация телефона — ещё один объяснимый признак в вашей модели риска.
Единый REST-контракт вместо поддержки нескольких разнородных интеграций.
Подключить одну базу — мало, собрать пять самим — долго и дорого в поддержке.
| Возможность | Один источник | Своя агрегация | ОКЗвонок |
|---|---|---|---|
| Единый verdict | частично | нужно разработать | да |
| Детализация по источникам | нет | да | да |
| Score 0–100 | зависит от сервиса | нужно разработать | да |
| Offline + Online | редко | нужно поддерживать | да |
| Bulk до 1000 | зависит от сервиса | нужно разработать | да |
| История снятой метки | редко | нужно хранить | да |
Сравнение описывает тип интеграции и не гарантирует превосходство качества над каждым отдельным поставщиком. В техническом ответе источники обозначены как yandex, kaspersky, mts, callfilter и yota — это идентификаторы сигнала, а не знак партнёрства или одобрения правообладателя.
Ключи, проверки, история и команда управляются самостоятельно. Зарегистрировались — и сразу работаете.
Выпускайте ключи под каждую систему и задавайте квоты отдельно.
Один номер, список или файл — с фильтрами и экспортом в CSV.
Журнал проверок, расход Offline и Online по каждому ключу.
Владелец, администратор, разработчик, бухгалтер — по ссылке-приглашению.
Offline и Online считаются отдельно: вы не переплачиваете за свежую допроверку всего массива.
Попробовать и встроить
0 ₽
без карты и менеджера
Начать бесплатноДля рабочего потока
По объёму
квоты под ваш поток
Рассчитать стоимостьДля крупных интеграций
Договор
индивидуальные условия
Связаться с намиScore показывает суммарный вес источников, в которых номер получил негативный сигнал. Значение ограничено диапазоном 0–100. Это не вероятность мошенничества и не кредитный рейтинг.
spam означает, что хотя бы один доступный источник отметил номер негативно. ok — источники знают номер, но не вернули спам-метку. unknown — данных для вывода недостаточно, и это не равно «номер безопасен».
Один из поддерживаемых источников ранее возвращал негативную метку, а затем снял её или перестал содержать номер в актуальном спам-множестве. API сохраняет источник, последнюю категорию и дату такого изменения.
Да. Bulk endpoint принимает от 1 до 1000 номеров в одном JSON-запросе. Невалидный элемент не отменяет результаты остальных.
Когда нужен свежий сигнал по конкретному номеру: например, для unknown после массовой Offline-проверки или для контакта с высокой ценностью.
API вернёт доступный офлайн-результат, добавит online_failed: true и укажет billed_as: offline. Онлайн-квота при этом не списывается.
Нет. API не возвращает ФИО, паспортные данные, адрес, баланс, содержание звонков или сообщений.
Пока нет. Поля operator и region определяются по справочнику диапазонов нумерации, поэтому показывают оператора, которому номер был выделен изначально.
Не следует. API-ключ должен храниться на backend вашей системы: браузер обращается к вашему серверу, а сервер — к ОКЗвонок.
Да. Один номер проверяется на главной без регистрации — до 5 раз в сутки. Для интеграции зарегистрируйтесь в кабинете и выпустите API-ключ: карта и звонок менеджеру не нужны.
Лимит 5 проверок в сутки защищает сервис от автоматического перебора номеров. Для регулярных и массовых проверок предназначен API.
Подключите ту же проверку к CRM, телефонии или антифроду — без заявок и согласований.
Нужны большие объёмы или договор? Напишите нам — подберём условия.