Документация API | NadoData — Интеграция сервисов проверки данных

IP-геолокация и анализ сети

Определение географического положения, параметров сети и наличия прокси по IPv4 или IPv6 адресу.

Параметр	Описание
ip	Запрошенный IP-адрес
continent_code	Код континента (NA, EU, AS и т.д.)
country_code	ISO-код страны (RU, US, FI и т.д.)
country	Название страны на русском языке
is_eu	Находится ли страна в Европейском Союзе (true/false)
region_code / region	Код и название региона (если доступно)
lat / lon	Широта и долгота
accuracy_radius	Радиус точности определения координат в км
timezone	Часовой пояс (например, Europe/Helsinki)
isp	Название интернет-провайдера или организации
asn	Номер автономной системы (ASN) провайдера
proxy	Определяет, используется ли прокси или VPN-сервер (true/false)

Пример 1: Обычный IPv4 запрос

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/ip/ip=32.49.112.0" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
{
  "ip": "32.49.112.0",
  "continent_code": "NA",
  "country_code": "US",
  "country": "США",
  "is_eu": false,
  "lat": 37.751,
  "lon": -97.822,
  "accuracy_radius": 1000,
  "timezone": "America/Chicago",
  "isp": "AT&T Enterprises, LLC",
  "asn": 7018,
  "proxy": false
}

Пример 2: Поддержка IPv6

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/ip/ip=2a00:1450:4010:c0f::65" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
{
  "ip": "2a00:1450:4010:c0f::65",
  "continent_code": "EU",
  "country_code": "FI",
  "country": "Финляндия",
  "is_eu": true,
  "region_code": "09",
  "region": "Кюменлааксо",
  "lat": 60.862,
  "lon": 26.7013,
  "accuracy_radius": 200,
  "timezone": "Europe/Helsinki",
  "isp": "Google LLC",
  "asn": 15169,
  "proxy": false
}

Поиск банковских реквизитов (БИК, SWIFT, кор.счёт)

Поиск реквизитов, счетов и проверка активности российских и зарубежных банковских учреждений (включая банки стран СНГ, Азии и международные финансовые организации) по БИК, SWIFT или регистрационному номеру.

Параметр	Описание
bic	Банковский идентификационный код (БИК)
swift	SWIFT-код банка в международной системе
name_ru / name_en	Официальное наименование банка
registration_number	Регистрационный номер, присвоенный ЦБ РФ
uid	Уникальный идентификатор ED807
status	Текущий статус (ACTIVE / INACTIVE)
country_code / region_code	ISO-код страны (RU, KZ, BY, TJ и т.д.)
postal_code / settlement	Индекс и населенный пункт регистрации
address	Точный адрес отделения или банка
is_main_branch	Является ли данное отделение головным (true/false)
accounts	Массив открытых счетов в ЦБ (корреспондентские и др.)

Пример 1: Поиск по БИК

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/bank/bic=044525225" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
[
  {
    "bic": "044525225",
    "swift": "SABRRUMM012",
    "name_ru": "ПАО Сбербанк",
    "name_en": "SBERBANK",
    "registration_number": "1481",
    "uid": "4525225000",
    "status": "ACTIVE",
    "country_code": "RU",
    "region_code": "45",
    "postal_code": "117312",
    "settlement": "г Москва",
    "address": "улица Вавилова, дом 19",
    "is_main_branch": true,
    "accounts": [
      {
        "correspondent_account": "30101810400000000225",
        "account_type": "Correspondent_account",
        "status": "ACTIVE",
        "date_opened": "1999-09-27"
      }
    ]
  }
]

Пример 2: Поиск по SWIFT-коду

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/bank/swift=OTPVRUMMXXX" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
[
  {
    "bic": "044525311",
    "swift": "OTPVRUMMXXX",
    "name_ru": "АО "ОТП Банк"",
    "name_en": "JOINT STOCK COMPANY 'OTP BANK'",
    "registration_number": "2766",
    "uid": "4525311000",
    "status": "ACTIVE",
    "country_code": "RU",
    "region_code": "45",
    "postal_code": "125171",
    "settlement": "г Москва",
    "address": "Ленинградское шоссе, д.16А, стр. 2",
    "is_main_branch": true,
    "accounts": [
      {
        "correspondent_account": "30101810000000000311",
        "account_type": "Correspondent_account",
        "status": "ACTIVE",
        "date_opened": "1998-03-25"
      }
    ]
  }
]

Пример 3: Поиск по корреспондентскому счету

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/bank/account=30101810400000000225" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
[
  {
    "bic": "044525225",
    "swift": "SABRRUMM012",
    "name_ru": "ПАО Сбербанк",
    "name_en": "SBERBANK",
    "registration_number": "1481",
    "uid": "4525225000",
    "status": "ACTIVE",
    "country_code": "RU",
    "region_code": "45",
    "postal_code": "117312",
    "settlement": "г Москва",
    "address": "улица Вавилова, дом 19",
    "is_main_branch": true,
    "accounts": [
      {
        "correspondent_account": "30101810400000000225",
        "account_type": "Correspondent_account",
        "status": "ACTIVE",
        "date_opened": "1999-09-27"
      }
    ]
  }
]

Пример 4: Поиск по регистрационному номеру ЦБ РФ

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/bank/reg=1481" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
[
  {
    "bic": "044525225",
    "swift": "SABRRUMM012",
    "name_ru": "ПАО Сбербанк",
    "name_en": "SBERBANK",
    "registration_number": "1481",
    "uid": "4525225000",
    "status": "ACTIVE",
    "country_code": "RU",
    "region_code": "45",
    "postal_code": "117312",
    "settlement": "г Москва",
    "address": "улица Вавилова, дом 19",
    "is_main_branch": true,
    "accounts": [
      {
        "correspondent_account": "30101810400000000225",
        "account_type": "Correspondent_account",
        "status": "ACTIVE",
        "date_opened": "1999-09-27"
      }
    ]
  }
]

AI-модерация и анализ токсичности текста

Интеллектуальная фильтрация контента с помощью нейросетей. Распознает скрытый мат, транслит и токсичные выражения в комментариях и чатах.

Параметр	Описание
result	Итоговый вердикт системы (БЕЗ_МАТА / МАТ)
toxic_score	Вероятность наличия ненормативной лексики (от 0.0 до 100.0)

Пример 1: Чистый текст (Обычное общение)

Request (POST)
curl -X POST "https://nadodata.ru/api/text" \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -d "Спасибо, заказ получил. Всё отлично работает!"

Response JSON
{
  "result": "БЕЗ_МАТА",
  "toxic_score": 1.2
}

Пример 2: Открытый мат

Request (POST)
curl -X POST "https://nadodata.ru/api/text" \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -d "Ну ты и блядь"

Response JSON
{
  "result": "МАТ",
  "toxic_score": 100.0
}

Пример 3: Завуалированный мат (символы и пробелы)

Request (POST)
curl -X POST "https://nadodata.ru/api/text" \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -d "Это полный п 1 з д 3 ц"

Response JSON
{
  "result": "МАТ",
  "toxic_score": 100.0
}

Информация о номерах

Определение оператора, домашнего региона и типа связи по номеру телефона (включает поиск часового пояса и ИНН провайдера).

Параметр	Описание
type	Категория номера (Мобильный, Стационарный, Бесплатный вызов)
region	Домашний регион (субъект или город), за которым закреплен номер
original_provider	Исходный оператор связи, которому выдан пул номеров
timezone	Вычисленный часовой пояс для региона в формате UTC
inn	ИНН компании-оператора (при наличии)

Пример 1: Мобильный номер (9xx)

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/num/phone=89884563311" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
{
  "type": "Мобильный",
  "region": "Республика Дагестан",
  "original_provider": "ПАО МТС",
  "timezone": "UTC+3",
  "inn": "7740000076"
}

Пример 2: Стационарный номер города (4xx / 8xx / 3xx)

Request (GET)
curl -X GET \
  "https://nadodata.ru/api/num/phone=88124563311" \
  -H "X-API-Key: ВАШ_КЛЮЧ"

Response JSON
{
  "type": "Стационарный",
  "region": "г. Санкт-Петербург",
  "original_provider": "ООО ЭЛИТЕЛ ТЕЛЕКОМ ГРУПП",
  "timezone": "UTC+3",
  "inn": "7802829204"
}

API Документация

IP-геолокация и анализ сети

Поиск банковских реквизитов (БИК, SWIFT, кор.счёт)

AI-модерация и анализ токсичности текста

Информация о номерах