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

Руководство по использованию прокси

Все настройки гео-таргетинга и ротации задаются прямо в username через суффиксы. Пароль и хост/порт не меняются — меняется только username.

Подключение

Хостv1.soxway.io

Порт HTTP / HTTPS5000HTTP-прокси, туннелирует HTTPS через CONNECT

Порт SOCKS51080

Usernameyour_username(+ опциональные суффиксы — см. Гео-таргетинг)

Парольyour_password(всегда неизменный)

Отдельный порт для HTTPS не нужен — направьте клиент на HTTP-прокси (5000), и TLS согласуется end-to-end через туннель CONNECT. Прокси не видит ваш открытый трафик.

Форматы подключения

# HTTP / HTTPS (TLS negotiated after CONNECT)
http://your_username:[email protected]:5000

# SOCKS5
socks5://your_username:[email protected]:1080

Примеры кода

curl

# HTTP
curl -x http://your_username:[email protected]:5000 https://ipinfo.io

# SOCKS5
curl --socks5 v1.soxway.io:1080 -U your_username:your_password https://ipinfo.io

Python (requests)

import requests

proxies = {
    "http":  "http://your_username:[email protected]:5000",
    "https": "http://your_username:[email protected]:5000",
}

r = requests.get("https://ipinfo.io/json", proxies=proxies)
print(r.json())

Node.js (axios)

import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
    'http://your_username:[email protected]:5000'
);

const res = await axios.get('https://ipinfo.io/json', { httpsAgent: agent });
console.log(res.data);

Гео-таргетинг

Добавляйте суффиксы к username для выбора локации. Их можно комбинировать в любом порядке; рекомендуемый порядок — гео → сессия → ttl. Пробелы заменяйте дефисом (-), например _city-new-york.

Суффикс	Описание	Пример
`_country-XX`	Страна, ISO 3166-1 alpha-2	`_country-US`
`_region-Name`	Регион / штат	`_region-bavaria`
`_city-Name`	Город	`_city-london`
`_isp-Name`	ISP / оператор	`_isp-vodafone`

# US only — rotation
socks5://your_username_country-US:[email protected]:1080

# Germany + Bavaria region
http://your_username_country-DE_region-bavaria:[email protected]:5000

# UK + London city
http://your_username_country-GB_city-london:[email protected]:5000

Режимы ротации

Ротация (по умолчанию)

Новый IP на каждый запрос. Максимум анонимности, лучше всего для скрапинга. Суффикс не нужен.

Стабильная — _s-SessionID

Один IP держится столько, сколько позволяет апстрим. Один и тот же Session ID всегда даёт один и тот же IP.

socks5://your_username_country-GB_s-mySessionId:[email protected]:1080

Sticky — _s-SessionID + _ttl-Nm

IP держится N минут/часов, затем ротируется. Разные Session ID дают разные IP. _ttl- работает и без _s- (сессия создаётся автоматически).

# same IP for 30 min, then rotate
socks5://your_username_country-GB_s-ee2323b3_ttl-30m:[email protected]:1080

# all parameters together
socks5://your_username_country-GB_region-england_city-london_s-abc123_ttl-60m:[email protected]:1080

Справочник суффиксов

{token}[_country-XX][_region-Name][_city-Name][_isp-Name][_s-SessionID][_ttl-Nm]

Суффикс	Значения	Примечания
`_country-XX`	ISO 3166-1 alpha-2 (US, DE, GB…)	регистронезависимо
`_region-Name`	Название региона/штата	пробелы как -
`_city-Name`	Название города	пробелы как -
`_isp-Name`	Название ISP/оператора	пробелы как -
`_s-SessionID`	Любая строка	тот же ID → тот же IP
`_ttl-Nm / _ttl-Nh`	_ttl-30m, _ttl-2h	держать IP N мин/часов

Поддержка гео по типам прокси

Суффиксы всегда принимаются шлюзом, но что именно поддерживает каждый пул — различается. Неподдерживаемые суффиксы тихо игнорируются.

Суффикс / режим	Residential	Mobile	4G Mobile
`_country-`	✅	✅	🔒
`_region-`	✅	❌	🔒
`_city-`	✅	✅	🔒
`_isp-`	✅	❌	🔒
`_s- (stable)`	✅	✅	🔄
`_ttl- (sticky)`	✅ ≤120m	✅ 10m	🔄

✅ поддерживается · ❌ игнорируется этим пулом

🔒 — локация фиксируется при покупке; гео-суффиксы её не меняют

🔄 — ротация управляется через API, а не суффиксами username

≤120m — время жизни sticky ограничено 120 минутами

Прокси API

Интеграция прокси за минуты

REST API для прокси с примерами кода на 13+ языках. Подключите резидентские и мобильные прокси к вашему приложению.

Код прокси API

1#!/usr/bin/env bash
2
3API_TOKEN="<your_api_token>"
4
5curl -s "https://api.soxway.io/v1/account/balance" \
6  -H "Authorization: Bearer $API_TOKEN" \
7  -H "Accept: */*"

Ответ (JSON)200 OK

1{
2  "data": {
3    "balance":  25.5,
4    "currency": "USD"
5  }
6}

API документация Получить API ключ

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

Руководство по использованию прокси

Подключение

Хостv1.soxway.io

Порт HTTP / HTTPS5000HTTP-прокси, туннелирует HTTPS через CONNECT

Порт SOCKS51080

Usernameyour_username(+ опциональные суффиксы — см. Гео-таргетинг)

Парольyour_password(всегда неизменный)

Форматы подключения

# HTTP / HTTPS (TLS negotiated after CONNECT)
http://your_username:[email protected]:5000

# SOCKS5
socks5://your_username:[email protected]:1080

Примеры кода

curl

# HTTP
curl -x http://your_username:[email protected]:5000 https://ipinfo.io

# SOCKS5
curl --socks5 v1.soxway.io:1080 -U your_username:your_password https://ipinfo.io

Python (requests)

import requests

proxies = {
    "http":  "http://your_username:[email protected]:5000",
    "https": "http://your_username:[email protected]:5000",
}

r = requests.get("https://ipinfo.io/json", proxies=proxies)
print(r.json())

Node.js (axios)

import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
    'http://your_username:[email protected]:5000'
);

const res = await axios.get('https://ipinfo.io/json', { httpsAgent: agent });
console.log(res.data);

Гео-таргетинг

Суффикс	Описание	Пример
`_country-XX`	Страна, ISO 3166-1 alpha-2	`_country-US`
`_region-Name`	Регион / штат	`_region-bavaria`
`_city-Name`	Город	`_city-london`
`_isp-Name`	ISP / оператор	`_isp-vodafone`

# US only — rotation
socks5://your_username_country-US:[email protected]:1080

# Germany + Bavaria region
http://your_username_country-DE_region-bavaria:[email protected]:5000

# UK + London city
http://your_username_country-GB_city-london:[email protected]:5000

Режимы ротации

Ротация (по умолчанию)

Новый IP на каждый запрос. Максимум анонимности, лучше всего для скрапинга. Суффикс не нужен.

Стабильная — _s-SessionID

Один IP держится столько, сколько позволяет апстрим. Один и тот же Session ID всегда даёт один и тот же IP.

socks5://your_username_country-GB_s-mySessionId:[email protected]:1080

Sticky — _s-SessionID + _ttl-Nm

# same IP for 30 min, then rotate
socks5://your_username_country-GB_s-ee2323b3_ttl-30m:[email protected]:1080

# all parameters together
socks5://your_username_country-GB_region-england_city-london_s-abc123_ttl-60m:[email protected]:1080

Справочник суффиксов

{token}[_country-XX][_region-Name][_city-Name][_isp-Name][_s-SessionID][_ttl-Nm]

Суффикс	Значения	Примечания
`_country-XX`	ISO 3166-1 alpha-2 (US, DE, GB…)	регистронезависимо
`_region-Name`	Название региона/штата	пробелы как -
`_city-Name`	Название города	пробелы как -
`_isp-Name`	Название ISP/оператора	пробелы как -
`_s-SessionID`	Любая строка	тот же ID → тот же IP
`_ttl-Nm / _ttl-Nh`	_ttl-30m, _ttl-2h	держать IP N мин/часов

Поддержка гео по типам прокси

Суффикс / режим	Residential	Mobile	4G Mobile
`_country-`	✅	✅	🔒
`_region-`	✅	❌	🔒
`_city-`	✅	✅	🔒
`_isp-`	✅	❌	🔒
`_s- (stable)`	✅	✅	🔄
`_ttl- (sticky)`	✅ ≤120m	✅ 10m	🔄

✅ поддерживается · ❌ игнорируется этим пулом

🔒 — локация фиксируется при покупке; гео-суффиксы её не меняют

🔄 — ротация управляется через API, а не суффиксами username

≤120m — время жизни sticky ограничено 120 минутами

Прокси API

Интеграция прокси за минуты

Код прокси API

1#!/usr/bin/env bash
2
3API_TOKEN="<your_api_token>"
4
5curl -s "https://api.soxway.io/v1/account/balance" \
6  -H "Authorization: Bearer $API_TOKEN" \
7  -H "Accept: */*"

Ответ (JSON)200 OK

1{
2  "data": {
3    "balance":  25.5,
4    "currency": "USD"
5  }
6}

API документация Получить API ключ

Руководство по использованию прокси

Подключение

Форматы подключения

Примеры кода

Гео-таргетинг

Режимы ротации

Ротация (по умолчанию)

Стабильная — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Справочник суффиксов

Поддержка гео по типам прокси

Интеграция прокси за минуты

Готовы масштабироваться с
премиальными прокси?

Руководство по использованию прокси

Подключение

Форматы подключения

Примеры кода

Гео-таргетинг

Режимы ротации

Ротация (по умолчанию)

Стабильная — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Справочник суффиксов

Поддержка гео по типам прокси

Интеграция прокси за минуты

Готовы масштабироваться с
премиальными прокси?

Руководство по использованию прокси

Подключение

Форматы подключения

Примеры кода

Гео-таргетинг

Режимы ротации

Ротация (по умолчанию)

Стабильная — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Справочник суффиксов

Поддержка гео по типам прокси

Интеграция прокси за минуты

Готовы масштабироваться спремиальными прокси?

Руководство по использованию прокси

Подключение

Форматы подключения

Примеры кода

Гео-таргетинг

Режимы ротации

Ротация (по умолчанию)

Стабильная — _s-SessionID

Sticky — _s-SessionID + _ttl-Nm

Справочник суффиксов

Поддержка гео по типам прокси

Интеграция прокси за минуты

Готовы масштабироваться спремиальными прокси?

Готовы масштабироваться с
премиальными прокси?

Готовы масштабироваться с
премиальными прокси?