Документация по 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, чтобы добавить, сколько каждой позиции свободно прямо сейчас.
1tierstringНеобязательноПо какому тарифу показать наличие.
economybasicturboПо умолчанию:basicmodemsstringНеобязательноУкажите 1 вместе с state, чтобы получить все модемы штата, свободные и занятые, и сколько каждый держит IP. Те же поля, что в /mobile/proxies/PROXY_ID/modems.
1carrierintegerНеобязательноId оператора. С modems=1 выводит только модемы этого оператора.
curl "https://socksnode.com/api/v1/mobile/catalog?state=12&availability=1" \
-H "Authorization: Bearer sk_YOUR_API_KEY"{
"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"{
"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"{
"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По умолчанию:basicdurationKeystringОбязательноСрок аренды. Должен продаваться в этом тарифе.
2h12h1d3d7d15d30dquantityintegerНеобязательноСколько портов арендовать, 1–50. Если часть не создана, вы платите только за остальные.
По умолчанию:
1countryIdintegerНеобязательно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"
}'{
"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"
}'{
"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"{
"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"{
"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}API-ключ не нужен
GET/mobile/proxies/{id}/rotate?token=…
одна ссылка для копирования из личного кабинета. Откройте её (браузер, curl, cron-задача, закладка), чтобы сменить IP; добавьте параметры локации, чтобы вместо этого сменить страну/штат/оператора.
Параметры запроса
tokenstringОбязательноТокен ротации порта, с его карточки в панели. API-ключ не нужен.
countryIdintegerНеобязательноНеобязательно. Сменить локацию, а не только IP.
cityIdintegerНеобязательноId штата из каталога.
spIdintegerНеобязательноId оператора из каталога.
formatstringНеобязательноФормат ответа.
jsonhtmlПо умолчанию:json
curl "https://socksnode.com/api/v1/mobile/proxies/PROXY_ID/rotate?token=YOUR_ROTATE_TOKEN"{
"ok": true,
"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"{
"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"
}'{
"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 из списка подключаются без пароля.
userpasswhitelistallowedIpsstring[]НеобязательноДо 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"
]
}'{
"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"
}'{
"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-ключ для автоматизации.