subnetchecker

DEVELOPER PLATFORM

Данные о подсетях.
В вашем приложении.

REST API для каталога IPv4 /24, истории маршрутов и пересечений с опубликованными белыми списками.

BASE URLhttps://subnetchecker.com/v1
  1. Создайте ключБез регистрации. Назовите интеграцию и выберите срок.
  2. Выполните запросПередавайте Authorization: Bearer <key>.
  3. Подключите приложениеИспользуйте примеры и спецификацию OpenAPI.

LIVE REQUEST

Проверьте API здесь

Консоль обращается к рабочему API. Ключ хранится только в памяти этой страницы.

Ответ появится после запроса
{}
Отзыв потребует второго нажатия.

Ключи и авторизация

Получите ключ через POST /v1/keys или форму выше. Все остальные методы требуют заголовок Authorization: Bearer sc_live_…. Ключи равноправны: чтение публичных данных и запуск ограниченного числа проверок. Они не дают доступа к Telegram ID, уведомлениям и личным настройкам.

Срок — 1–365 дней, по умолчанию 30. Сервер сохраняет только SHA-256 ключа. Восстановить секрет нельзя: создайте новый. Ключи, созданные в авторизованной панели, можно отозвать в её разделе API; любой ключ также отзывает сам себя методом DELETE /v1/key.

Передавайте ключ только через HTTPS и заголовок. Не помещайте его в URL или опубликованный исходный код. CORS разрешает внешние приложения без cookie. Для своего веб-продукта храните ключ на сервере, а не в браузере посетителя.

Лимиты и ошибки

ОперацияОграничение
Авторизованные запросы60 в минуту и 10 000 в сутки на ключ
Новые проверки3 в минуту и 20 в сутки на ключ
Публичное создание ключей10 в час для всех анонимных клиентов; 100 ключей в сутки на сервис
Общие пределы сервиса600 запросов в минуту; 60 новых проверок в час; очередь до 8 проверок

Фиксированные окна UTC, а не скользящие интервалы. Запрос к свежему кэшу и повтор уже выполняющейся проверки не расходуют квоту новых проверок, но расходуют квоту запросов. Создание ключей из панели имеет отдельное часовое окно на аккаунт. При перегрузке вернётся 429 и Retry-After в секундах.

429 · application/json
{"error":{"code":"rate_limited","message":"Лимит запросов исчерпан."},"request_id":"a98c4b6d2e710f33"}
HTTPДействие клиента
200 / 201 / 202Успех / ключ создан / проверка в очереди
400Исправить JSON, префикс или параметры
401Проверить ключ, его срок или отзыв
404 / 405Проверить путь и HTTP-метод
415Передать Content-Type: application/json
429Повторить после Retry-After; не запускать циклические повторы без ожидания
500Повторить с паузой. Сохранить X-Request-ID для диагностики

Все JSON-ответы API содержат request_id; тот же идентификатор находится в X-Request-ID. Ошибки внешних источников внутри завершённого досье перечисляются в data.errors и не всегда означают HTTP 500.

Как читать данные

Цены
Целые значения в сотых долях указанной валюты: 12029 USD → $120.29. monthly_price_cents — месячный платёж; setup_price_cents — подключение; deposit_cents — депозит. null означает «не опубликовано», а 0 — опубликованный нулевой платёж.
Страна
country в каталоге — сведения продавца, а не результат независимого измерения. Геобаза находится в history.data.geo.
Выборка
sample=true — поставщик публикует только часть каталога. Исчезновение из выборки не доказывает продажу сети.
Даты
Поля *_at в оболочке API — UTC ISO 8601. published_at и даты в исходных RIPE-данных сохраняют формат источника. data.checked в досье — Unix seconds; даты RIS без Z интерпретируются как UTC.
Пагинация
Используйте pagination.next_offset до null. Каталог меняется между запросами; это не фиксированный экспортный снимок. Для обхода храните уникальную пару (source, prefix), затем при необходимости повторите синхронизацию.
Белые списки
По умолчанию допускаются публикации не старше 30 дней, неизвестные даты исключаются. max_age_days=0 включает архивы. ready=false означает отсутствие подходящих загруженных источников, а не проверенный отрицательный результат. covered=256 — совпадение всех адресов со списком, а не гарантия доступности сейчас.
История
registration — реестр; versions — версии записи; routes — анонсировавшие ASN, покрывающие /16–/24 и отдельные периоды; transfers — опубликованные передачи. BGP-оператор не обязательно юридический владелец. Пустой transfers не доказывает отсутствие передач.
Свежесть
Каталоги опрашиваются каждые 5 минут. API читает последние успешные снимки, кратко кэшируя сборку ответа до 10 секунд. Проверка истории — по запросу. Просматривайте checked_at и healthy каждого источника.

Готовые примеры

Замените ключ и выполните пример в своём окружении.

cURL

Shell
# Store your key locally, do not commit it.
export SUBNET_API_KEY='sc_live_YOUR_KEY'
curl --fail-with-body --get 'https://subnetchecker.com/v1/subnets' \
  -H "Authorization: Bearer $SUBNET_API_KEY" \
  --data-urlencode 'limit=20' \
  --data-urlencode 'sort=new'

curl --fail-with-body 'https://subnetchecker.com/v1/checks' \
  -H "Authorization: Bearer $SUBNET_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"prefix":"95.21.145.0/24"}' 

Python

Python 3 · pip install requests
import os, time, requests

BASE = "https://subnetchecker.com"
session = requests.Session()
session.headers["Authorization"] = "Bearer " + os.environ["SUBNET_API_KEY"]

def call(method, path, **kwargs):
    for attempt in range(4):
        response = session.request(method, BASE + path, timeout=30, **kwargs)
        if response.status_code == 429:
            time.sleep(min(int(response.headers.get("Retry-After", "30")), 120))
            continue
        response.raise_for_status()
        return response.json()
    raise RuntimeError("Rate limit: retry later")

# Paginated inventory, deduplicated across changing snapshots.
offset, seen = 0, set()
while True:
    result = call("GET", "/v1/subnets", params={"limit": 100, "offset": offset})
    for item in result["data"]:
        identity = (item["source"], item["prefix"])
        if identity not in seen:
            seen.add(identity)
            print(item["prefix"], item["source"], item["monthly_price_cents"])
    offset = result["pagination"]["next_offset"]
    if offset is None:
        break

# Collect a dossier, then poll for up to three minutes.
prefix = "95.21.145.0/24"
call("POST", "/v1/checks", json={"prefix": prefix})
for attempt in range(36):
    result = call("GET", "/v1/history", params={"prefix": prefix})["data"]
    if result["state"] != "running":
        if result["state"] == "error":
            raise RuntimeError("Dossier collection failed")
        print(result["data"])
        break
    time.sleep(5)
else:
    raise TimeoutError("Still processing; poll again later")

JavaScript

Node.js 18+
// Node.js 18+. Set SUBNET_API_KEY in your environment.
const key = process.env.SUBNET_API_KEY;
if (!key) throw new Error('SUBNET_API_KEY is required');
const url = new URL('https://subnetchecker.com/v1/subnets');
url.search = new URLSearchParams({ limit: '20', sort: 'new' });
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
  signal: AbortSignal.timeout(30000)
});
const body = await response.json();
if (!response.ok) throw new Error(`${response.status}: ${body.error.message}`);
for (const subnet of body.data) console.log(subnet.prefix, subnet.source);

POST /v1/keys

Создать ключ

Без регистрации. Ключ показывается один раз; сохраните его в переменной окружения. Если запрос выполнен из авторизованной панели, ключ также появится в разделе API.

ПараметрОписание
namestring · JSON По умолчанию: Моя интеграция.
expires_in_daysinteger · JSON По умолчанию: 30. От 1 до 365.
201 · application/json
{
  "data": {
    "id": "0e72fa768b13c941",
    "name": "Мониторинг",
    "key": "sc_live_EXAMPLE_REPLACE_WITH_YOUR_KEY",
    "created_at": "2026-11-17T12:00:00Z",
    "expires_at": "2026-12-17T12:00:00Z",
    "limits": {
      "requests_per_minute": 60,
      "requests_per_day": 10000,
      "checks_per_day": 20
    }
  },
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

GET /v1/subnets

Каталог подсетей

Возвращает предложения из последних успешных снимков. Одна сеть у двух поставщиков — две записи. При ошибке источника сохраняется его предыдущий снимок; свежесть проверяйте через /v1/sources.

ПараметрОписание
limitintegerРазмер страницы. По умолчанию: 50. Диапазон: 1–200.
offsetintegerСмещение. По умолчанию: 0. Диапазон: 0–1000000.
sourcestringТочное имя поставщика, с учётом регистра.
countrystringДвухбуквенный код страны из каталога, например US.
prefixstringТочная подсеть /24.
matchstringВсе; хотя бы один IP в БС; все 256 IP. По умолчанию: all. all, any, full.
sortstringПо IPv4; новые первыми; валюта + цена без конвертации. По умолчанию: ip. ip, new, price.
max_age_daysintegerМаксимальный возраст публикации БС; 0 включает архивы и записи без даты. По умолчанию: 30. Диапазон: 0–3650.
whitelistarrayТочное имя из /v1/whitelists. Повторите параметр для нескольких источников.
200 · application/json
{
  "data": [
    {
      "prefix": "95.21.145.0/24",
      "source": "ONIE",
      "url": "https://onie.net/ru/ip-subnets",
      "country": "US",
      "currency": "USD",
      "monthly_price_cents": 12029,
      "setup_price_cents": 1149,
      "deposit_cents": null,
      "sample": false,
      "first_seen_at": "2026-11-17T10:00:00Z",
      "last_seen_at": "2026-11-17T10:05:00Z",
      "whitelist": {
        "matched_ips": 0,
        "total_ips": 256
      }
    }
  ],
  "request_id": "a98c4b6d2e710f33",
  "pagination": {
    "limit": 1,
    "offset": 0,
    "total": 1183,
    "next_offset": 1
  },
  "meta": {
    "generated_at": "2026-11-17T12:00:00Z",
    "max_age_days": 30,
    "active_whitelists": [
      "igareck endpoints /32 · конфигурации"
    ]
  }
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

GET /v1/sources

Поставщики

Каталоги с раскрытыми префиксами и счётчики без полных адресов. kind=counter не позволяет определить, какие именно сети доступны.

200 · application/json
{
  "data": [
    {
      "name": "Neterra",
      "kind": "prefixes",
      "url": "https://client.neterra.cloud/index.php?/cart/ipv4-for-rent",
      "checked_at": "2026-11-17T12:00:00Z",
      "healthy": true,
      "offers": 9
    },
    {
      "name": "ACE · ARIN",
      "kind": "counter",
      "url": "https://aceips.com/whmcs/index.php?rp=/store/arin-ipv4",
      "checked_at": "2026-11-17T12:00:00Z",
      "count": 3
    }
  ],
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

GET /v1/whitelists

Источники БС

Метаданные всех подключённых списков. published_at — публикация источника, fetched_at — наша загрузка. Поле older_than_30_days также true, если дата публикации неизвестна.

200 · application/json
{
  "data": [
    {
      "name": "hxehex",
      "published_at": "2026-05-09T00:00:00Z",
      "fetched_at": "2026-11-17T12:00:00Z",
      "revision": "example-revision",
      "url": "https://github.com/hxehex/russia-mobile-internet-whitelist",
      "ranges": 30222,
      "older_than_30_days": true
    }
  ],
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

GET /v1/matches

Пересечение с БС

Точное количество IP выбранной /24, попавших в объединение подходящих списков. Один адрес считается один раз. /32 никогда не расширяется до /24.

ПараметрОписание
prefixstring · обязательныйПроверяемая сеть.
max_age_daysintegerМаксимальный возраст публикации БС; 0 включает архивы и записи без даты. По умолчанию: 30. Диапазон: 0–3650.
whitelistarrayТочное имя из /v1/whitelists. Повторите параметр для нескольких источников.
200 · application/json
{
  "data": {
    "prefix": "95.21.145.0/24",
    "covered": 0,
    "ready": true,
    "sources": [],
    "max_age_days": 30
  },
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

POST /v1/checks

Запустить проверку

Асинхронно собирает регистрацию, BGP, передачи адресов и геолокацию. 202 означает постановку в очередь, а не завершение. Свежий кэш до 5 минут возвращает 200/state=cached. Дубликаты выполняющейся проверки не создают новое задание.

ПараметрОписание
prefixstring · JSONПубличный IPv4 /24. Адрес сети, без host bits.
202 · application/json
{
  "data": {
    "prefix": "95.21.145.0/24",
    "state": "running",
    "poll_url": "/v1/history?prefix=95.21.145.0%2F24"
  },
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

GET /v1/history

История и результат проверки

Читает сохранённое досье. Сам GET не запускает сетевую проверку. data=null и state=not_checked — результат пока не собран. Старый результат может присутствовать одновременно со state=running.

ПараметрОписание
prefixstring · обязательныйПроверяемая сеть.
max_age_daysintegerМаксимальный возраст публикации БС; 0 включает архивы и записи без даты. По умолчанию: 30. Диапазон: 0–3650.
whitelistarrayТочное имя из /v1/whitelists. Повторите параметр для нескольких источников.
200 · application/json
{
  "data": {
    "prefix": "95.21.145.0/24",
    "state": "cached",
    "updated_at": "2026-11-17T12:00:00Z",
    "data": {
      "prefix": "95.21.145.0/24",
      "checked": 1794916800,
      "errors": [],
      "registration": [
        {
          "type": "inetnum",
          "key": "95.21.0.0 - 95.21.255.255",
          "attributes": [
            {
              "key": "netname",
              "value": "JAZZTEL-TRIPLEPLAY"
            }
          ]
        }
      ],
      "registry_resource": "inetnum:95.21.0.0 - 95.21.255.255",
      "registry_type": "inetnum",
      "versions": [],
      "overview": {
        "asns": [
          {
            "asn": 12479,
            "holder": "UNI2-AS Orange Espagne SA"
          }
        ],
        "resource": "95.21.128.0/19"
      },
      "routes": [
        {
          "asn": "12715",
          "holder": "JAZZTEL",
          "prefix": "95.21.0.0/16",
          "exact": false,
          "periods": [
            {
              "start": "2010-01-19T00:00:00",
              "end": "2018-06-29T00:00:00"
            }
          ]
        }
      ],
      "transfers": [],
      "geo": [],
      "bs": {
        "covered": 0,
        "ready": true,
        "sources": []
      }
    }
  },
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

GET /v1/key

Текущий ключ

Возвращает метаданные использованного ключа. Секрет повторно не возвращается.

200 · application/json
{
  "data": {
    "id": "0e72fa768b13c941",
    "name": "Мониторинг",
    "created_at": "2026-11-17T12:00:00Z",
    "expires_at": "2026-12-17T12:00:00Z",
    "last_used_at": null
  },
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

DELETE /v1/key

Отозвать ключ

Немедленно отзывает ключ из Authorization. Следующий запрос с ним вернёт 401. Для ротации сначала создайте новый ключ, проверьте интеграцию, затем отзовите старый.

200 · application/json
{
  "data": {
    "revoked": true
  },
  "request_id": "a98c4b6d2e710f33"
}

Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.

Версионирование

Базовая версия — /v1. Клиент должен игнорировать неизвестные поля JSON. Новые необязательные поля могут добавляться в v1; несовместимое изменение требует новой версии пути.

Скачать спецификацию OpenAPI 3.1 · На главную