SocksNode
Разработчикам

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

Два способа интеграции с SocksNode: подключайтесь напрямую к прокси-шлюзу по HTTP(S) или SOCKS5, либо управляйте трафиком, использованием и прокси программно через REST API.

На этой странице

Мобильные прокси

REST API 4G/5G

Покупайте и управляйте мобильными прокси 4G/5G через API. Каждый Mobile IP — это один ротируемый IP оператора (до 3 подключений) на выбранный срок. Аренда и продление списываются с предоплаченного баланса аккаунта (USD). Используются права read:proxies / write:proxies.

https://socksnode.com/api/v1

Аутентификация

Базовый URL https://socksnode.com/api/v1. Создайте ключ в разделе Dashboard → API access и отправляйте его как токен Bearer. Ключи имеют ограниченную область действия — запрашивайте только то, что вам нужно.

Область действияПрава
read:usageБаланс и аналитика использования
read:proxiesСписок сохранённых учётных данных прокси
write:proxiesСоздание новых учётных данных прокси
purchaseПокупка ГБ для ротационных резидентных, датацентр- и мобильных прокси, покупка и продление статических и ISP IP, аренда и продление портов 4G/5G, автопродление, покупка IP на 24 часа, адресов и трафика IP Vault — списывается с баланса.

Ограничение частоты: 120 запросов в минуту на ключ (генерация прокси ограничивается дополнительно). Храните ключ в секрете и на стороне сервера.

GET /api/v1/account HTTP/1.1
Host: socksnode.com
Authorization: Bearer sk_YOUR_API_KEY

Ошибки

Ошибки возвращают тело JSON { "error": { "code", "message" } } с соответствующим HTTP-статусом:

СтатусЗначение
400Некорректное тело запроса или параметры
401Отсутствующий, недействительный или отозванный API-ключ
402Недостаточный баланс трафика для генерации прокси
403У API-ключа отсутствует требуемая область действия
404Не найдено или принадлежит не вам.
409Состояние порта сейчас не позволяет это, напр. срок истёк.
429Превышено ограничение частоты — см. заголовок Retry-After
502Сбой вышестоящей сети. Деньги не списаны.
503Продукт на обслуживании. Повторите чуть позже.
HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "error": {
    "code": "no_bandwidth",
    "message": "…"
  }
}

Эндпоинты API

сроки, страны, штаты и операторы

GET/mobile/catalog

Область действия: read:proxies

Параметры запроса

  • countryintegerНеобязательно

    Id страны. Возвращает её штаты.

  • stateintegerНеобязательно

    Id штата. Возвращает операторов.

  • availabilitystringНеобязательно

    Укажите 1, чтобы добавить, сколько каждой позиции свободно прямо сейчас.

    1

  • tierstringНеобязательно

    По какому тарифу показать наличие.

    economybasicturboПо умолчанию: basic

  • modemsstringНеобязательно

    Укажите 1 вместе с state, чтобы получить все модемы штата, свободные и занятые, и сколько каждый держит IP. Те же поля, что в /mobile/proxies/PROXY_ID/modems.

    1

  • carrierintegerНеобязательно

    Id оператора. С modems=1 выводит только модемы этого оператора.

curl "https://socksnode.com/api/v1/mobile/catalog?state=12&availability=1" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Ответ200
{
  "data": {
    "carriers": [
      { "id": 34, "name": "5G AT&T", "status": "ok", "pct": 82 },
      { "id": 35, "name": "5G T-Mobile", "status": "low", "pct": 11 },
      { "id": 36, "name": "5G Verizon", "status": "none", "pct": 0 }
    ]
  }
}
// status: "ok" | "low" | "none" | "unknown"
// Country and state stock is refreshed every ~15 min;
// carrier stock is checked live, right before you choose.

список ваших мобильных прокси (с учётными данными)

GET/mobile/proxies

Область действия: read:proxies

Без параметров.

curl "https://socksnode.com/api/v1/mobile/proxies" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Ответ200
{
  "data": [
    {
      "id": "clx…",
      "name": "Port 1",
      "host": "mobile.socksnode.com",
      "port": 9094,
      "protocol": "socks5",
      "username": "sn_a1b2c3d4",
      "password": "…",
      "authMode": "userpass",
      "allowedIps": [],
      "country": "UNITED STATES",
      "state": "FLORIDA",
      "carrier": "5G AT&T",
      "rotationMinutes": 15,
      "modem": { "id": "3f9c0a1b2d4e5f607182", "code": "K7QM" },
      "status": "active",
      "paused": false,
      "bytesUsed": 0,
      "lastExitIp": null,
      "expiresAt": "2026-10-30T04:46:53.000Z"
    }
  ]
}

один прокси

GET/mobile/proxies/{id}

включает израсходованные данные + последний исходящий IP

Область действия: read:proxies

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Ответ200
{
  "data": {
    "id": "clx…",
    "name": "Port 1",
    "host": "mobile.socksnode.com",
    "port": 9094,
    "protocol": "socks5",
    "username": "sn_a1b2c3d4",
    "password": "…",
    "authMode": "userpass",
    "allowedIps": [],
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "rotationMinutes": 15,
    "modem": { "id": "3f9c0a1b2d4e5f607182", "code": "K7QM" },
    "status": "active",
    "paused": false,
    "bytesUsed": 0,
    "lastExitIp": null,
    "expiresAt": "2026-10-30T04:46:53.000Z"
  }
}

купить N портов (списывается с баланса; 402 при нехватке)

POST/mobile/proxies

Область действия: purchase

Параметры тела

  • tierKeystringНеобязательно

    Тариф для аренды.

    economybasicturboПо умолчанию: basic

  • durationKeystringОбязательно

    Срок аренды. Должен продаваться в этом тарифе.

    2h12h1d3d7d15d30d

  • quantityintegerНеобязательно

    Сколько портов арендовать, 1–50. Если часть не создана, вы платите только за остальные.

    По умолчанию: 1

  • countryIdintegerНеобязательно

    Id страны из каталога. Не указывайте, чтобы взять любую доступную локацию.

  • cityIdintegerНеобязательно

    Id штата из каталога.

  • spIdintegerНеобязательно

    Id оператора из каталога.

  • modemIdstringНеобязательно

    Id модема из /mobile/catalog?modems=1 (тот же тариф). Нужны cityId и quantity 1. 409 modem_taken, если на модеме нет места; деньги не списываются.

  • protocolstringНеобязательно

    Протокол порта.

    sockshttpПо умолчанию: socks

curl -X POST "https://socksnode.com/api/v1/mobile/proxies" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "durationKey": "30d",
    "quantity": 1,
    "countryId": 1,
    "cityId": 12,
    "spId": 34,
    "protocol": "socks"
  }'
Ответ201
{
  "data": [
    {
      "id": "clx…",
      "name": "Port 1",
      "host": "mobile.socksnode.com",
      "port": 9094,
      "protocol": "socks5",
      "username": "sn_a1b2c3d4",
      "password": "…",
      "authMode": "userpass",
      "allowedIps": [],
      "country": "UNITED STATES",
      "state": "FLORIDA",
      "carrier": "5G AT&T",
      "rotationMinutes": 15,
      "modem": { "id": "3f9c0a1b2d4e5f607182", "code": "K7QM" },
      "status": "active",
      "paused": false,
      "bytesUsed": 0,
      "lastExitIp": null,
      "expiresAt": "2026-10-30T04:46:53.000Z"
    }
  ],
  "charged": 40
}

сменить страну/штат/оператора (бесплатно)

POST/mobile/proxies/{id}/switch

Область действия: write:proxies

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

Параметры тела

  • countryIdintegerОбязательно

    Id страны из каталога.

  • cityIdintegerНеобязательно

    Id штата из каталога.

  • spIdintegerНеобязательно

    Id оператора из каталога.

  • modemIdstringНеобязательно

    Id модема из списка модемов. Нужен cityId. Порт переходит только на этот модем: 409 modem_taken, если он занят, 404 modem_gone, если его больше нет в списке.

  • protocolstringНеобязательно

    По умолчанию текущий протокол порта.

    sockshttp

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/switch" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countryId": 3,
    "cityId": 12,
    "spId": 34,
    "modemId": "8d21e7c40b9a6f5e3c12"
  }'
Ответ200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

модемы штата для порта (свободные и занятые, время удержания IP)

GET/mobile/proxies/{id}/modems

Область действия: read:proxies

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

Параметры запроса

  • stateintegerОбязательно

    Id штата из каталога. Выводит модемы этого штата для тарифа этого порта.

  • carrierintegerНеобязательно

    Id оператора. С modems=1 выводит только модемы этого оператора.

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/modems?state=12&carrier=34" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Ответ200
{
  "data": {
    "modems": [
      {
        "id": "3f9c0a1b2d4e5f607182",
        "code": "K7QM",
        "carrier": "5G AT&T",
        "free": true,
        "current": true,
        "yours": 0,
        "yourPorts": [],
        "rotationMinutes": 30,
        "lastIp": "174.208.161.27",
        "lastOkAt": "2026-10-28T03:12:40.000Z",
        "failing": false
      },
      {
        "id": "8d21e7c40b9a6f5e3c12",
        "code": "R4XB",
        "carrier": "5G AT&T",
        "free": false,
        "current": false,
        "yours": 0,
        "yourPorts": [],
        "rotationMinutes": 60,
        "lastIp": null,
        "lastOkAt": null,
        "failing": false
      }
    ],
    "free": 1,
    "total": 2
  }
}
// free: has a slot for one more port. current: this port is on it.
// yours: your other live ports on it (they share its IP); yourPorts: their port numbers.
// rotationMinutes: how long the modem keeps one IP.

новый исходящий IP (бесплатно)

POST/mobile/proxies/{id}/rotate

Область действия: write:proxies

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/rotate" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Ответ200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

узнать текущий исходящий IP

GET/mobile/proxies/{id}/check-ip

Область действия: read:proxies

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/check-ip" \
  -H "Authorization: Bearer sk_YOUR_API_KEY"
Ответ200
{
  "data": { "ip": "174.208.161.27" }
}

переключить SOCKS5 ↔ HTTP(S)

POST/mobile/proxies/{id}/protocol

Область действия: write:proxies

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

Параметры тела

  • protocolstringОбязательно

    Протокол порта.

    sockshttp

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/protocol" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "protocol": "http"
  }'
Ответ200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

сменить режим авторизации

POST/mobile/proxies/{id}/auth

Область действия: write:proxies

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

Параметры тела

  • modestringОбязательно

    userpass — вход по логину и паролю; whitelist — IP из списка подключаются без пароля.

    userpasswhitelist

  • allowedIpsstring[]Необязательно

    До 3 публичных адресов IPv4 или IPv6, без диапазонов. Нужно для whitelist.

    По умолчанию: []

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/auth" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "whitelist",
    "allowedIps": [
      "203.0.113.7"
    ]
  }'
Ответ200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  }
}
// + every other field of GET /mobile/proxies/{id}

продлить порт (списывается с баланса)

POST/mobile/proxies/{id}/renew

Область действия: purchase

Параметры пути

  • idstringОбязательно

    Id мобильного прокси.

Параметры тела

  • durationKeystringОбязательно

    Срок аренды. Должен продаваться в тарифе порта.

    2h12h1d3d7d15d30d

curl -X POST "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/renew" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "durationKey": "30d"
  }'
Ответ200
{
  "data": {
    "id": "clx…",
    "host": "mobile.socksnode.com",
    "port": 9095,
    "protocol": "socks5",
    "country": "UNITED STATES",
    "state": "FLORIDA",
    "carrier": "5G AT&T",
    "status": "active"
  },
  "charged": 40
}
// + every other field of GET /mobile/proxies/{id}

Готовы приступить?

Создайте учётные данные в панели управления или получите API-ключ для автоматизации.