Руководство по интеграции прокси и REST API
Все, что нужно для подключения прокси ProxyVPN к коду, браузерам и инструментам: хосты, порты, параметры имени пользователя, готовые примеры и REST API.
Шлюзы и порты
Планы с резидентскими, мобильными и безлимитными прокси используют один шлюз каждый. Статические ISP, дата-центры и общие планы предоставляются в виде списков IP с собственными портами.
Жилые прокси
gw.proxyvpn.liveHTTP и HTTPS 7700, SOCKS5 7701
Мобильные прокси
4g.proxyvpn.liveHTTP и HTTPS 7800, SOCKS5 7801
Неограниченные жилые прокси
unl.proxyvpn.liveHTTP и HTTPS 7900, SOCKS5 7901
Параметры имени пользователя
Добавьте параметры к имени пользователя из раздела «Мои услуги». Их можно комбинировать в таком порядке.
-country-xxДвухбуквенный код страныUSER-country-us-city-nameГород в этой стране, строчными буквами, без пробеловUSER-country-de-city-frankfurt-session-nameСохраняет тот же IP до 60 минутUSER-country-gb-session-a1b2Примеры кода
Замените USER и PASS на свои данные для входа. Каждая вкладка, это полный пример.
curl -x http://USER-country-us:PASS@gw.proxyvpn.live:7700 https://api.ipify.org
# SOCKS5, sticky for up to 60 minutes
curl -x socks5h://USER-country-de-session-a1:PASS@gw.proxyvpn.live:7701 https://api.ipify.orgimport requests
proxy = "http://USER-country-gb:PASS@gw.proxyvpn.live:7700"
r = requests.get("https://api.ipify.org?format=json",
proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.json())import { ProxyAgent, fetch } from "undici";
const agent = new ProxyAgent("http://USER-country-jp:PASS@gw.proxyvpn.live:7700");
const res = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await res.json());from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(proxy={
"server": "http://gw.proxyvpn.live:7700",
"username": "USER-country-fr-city-paris",
"password": "PASS",
})
page = browser.new_page()
page.goto("https://api.ipify.org")
print(page.content())# settings.py
DOWNLOADER_MIDDLEWARES = {
"scrapy.downloadermiddlewares.httpproxy.HttpProxyMiddleware": 110,
}
# in your spider
yield scrapy.Request(url, meta={
"proxy": "http://USER-country-us:PASS@gw.proxyvpn.live:7700"
})# list plans (no key needed)
curl https://proxyvpn.live/api/v1/plans
# buy a plan from credit
curl -X POST https://proxyvpn.live/api/v1/orders \
-H "Authorization: Bearer pvk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"plan":"isp-25","country":"us"}'
# your services and logins
curl https://proxyvpn.live/api/v1/services -H "Authorization: Bearer pvk_YOUR_KEY"REST API
Базовый URL https://proxyvpn.live/api/v1. Отправьте ключ как Authorization: Bearer pvk_... Создайте ключ в разделе аккаунта. 300 запросов в минуту на один ключ.
| Метод | Путь | Ключ | Возвращает |
|---|---|---|---|
| GET | /api/v1/plans | Нет | Каждый план с его ценой, количеством и сроком |
| GET | /api/v1/locations | Нет | Страны, города и продукты, продаваемые в каждом |
| GET | /api/v1/balance | Да | Ваш баланс в USD |
| POST | /api/v1/orders | Да | Купить план за счет баланса: {plan, country} |
| GET | /api/v1/services | Да | Ваши планы с логинами, списками IP и датами окончания |
| GET | /api/v1/services/{id} | Да | Один план |
Ошибки
unauthorizedОтсутствует или неверный ключ API. Ничего не списывается.fundsБаланс меньше стоимости плана. Ничего не списывается.bad_plan / bad_countryНеизвестный план или страна, в которой продукт не продается. Ничего не списывается.rate_limitedБолее 300 запросов в минуту на один ключ.networkПлан не удалось настроить в данный момент. Ничего не списывается.Создайте ключ и начните разработку
Ключи API создаются в разделе аккаунта и показываются один раз.