Proxy integration guide and REST API
Everything you need to connect ProxyVPN proxies to code, browsers and tools: hosts, ports, username options, copy-ready examples and the REST API.
Gateways and ports
Residential, mobile and unlimited plans use one gateway each. Static ISP, datacenter and shared plans come as IP lists with their own ports.
Residential proxies
gw.proxyvpn.liveHTTP and HTTPS 7700, SOCKS5 7701
Mobile proxies
4g.proxyvpn.liveHTTP and HTTPS 7800, SOCKS5 7801
Unlimited residential proxies
unl.proxyvpn.liveHTTP and HTTPS 7900, SOCKS5 7901
Username options
Add options to the username from My services. They can be combined in this order.
-country-xxTwo letter country codeUSER-country-us-city-nameCity in that country, lowercase, no spacesUSER-country-de-city-frankfurt-session-nameKeeps the same IP for up to 60 minutesUSER-country-gb-session-a1b2Code examples
Replace USER and PASS with your login. Every tab is a complete example.
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
Base URL https://proxyvpn.live/api/v1. Send the key as Authorization: Bearer pvk_... Create the key in the account area. 300 requests a minute per key.
| Method | Path | Key | Returns |
|---|---|---|---|
| GET | /api/v1/plans | No | Every plan with its price, quantity and length |
| GET | /api/v1/locations | No | Countries, cities and the products sold in each |
| GET | /api/v1/balance | Yes | Your credit in USD |
| POST | /api/v1/orders | Yes | Buy a plan from credit: {plan, country} |
| GET | /api/v1/services | Yes | Your plans with logins, IP lists and end dates |
| GET | /api/v1/services/{id} | Yes | One plan |
Errors
unauthorizedMissing or wrong API key. Nothing is charged.fundsCredit is lower than the plan price. Nothing is charged.bad_plan / bad_countryUnknown plan, or a country the product is not sold in. Nothing is charged.rate_limitedMore than 300 requests a minute on one key.networkThe plan could not be set up right now. Nothing is charged.Create a key and start building
API keys are made in the account area and shown once.