DEVELOPER PLATFORM
Данные о подсетях.
В вашем приложении.
REST API для каталога IPv4 /24, истории маршрутов и пересечений с опубликованными белыми списками.
https://subnetchecker.com/v1- Создайте ключБез регистрации. Назовите интеграцию и выберите срок.
- Выполните запросПередавайте Authorization: Bearer <key>.
- Подключите приложениеИспользуйте примеры и спецификацию 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 в секундах.
{"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
# 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
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+. 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. |
{
"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. Повторите параметр для нескольких источников. |
{
"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 не позволяет определить, какие именно сети доступны.
{
"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, если дата публикации неизвестна.
{
"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. Повторите параметр для нескольких источников. |
{
"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. |
{
"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. Повторите параметр для нескольких источников. |
{
"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
Текущий ключ
Возвращает метаданные использованного ключа. Секрет повторно не возвращается.
{
"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. Для ротации сначала создайте новый ключ, проверьте интеграцию, затем отзовите старый.
{
"data": {
"revoked": true
},
"request_id": "a98c4b6d2e710f33"
}Иллюстративный ответ. Цены, наличие и даты в текущем снимке могут отличаться.
Версионирование
Базовая версия — /v1. Клиент должен игнорировать неизвестные поля JSON. Новые необязательные поля могут добавляться в v1; несовместимое изменение требует новой версии пути.