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.live

HTTP and HTTPS 7700, SOCKS5 7701

Mobile proxies

4g.proxyvpn.live

HTTP and HTTPS 7800, SOCKS5 7801

Unlimited residential proxies

unl.proxyvpn.live

HTTP 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-a1b2

Code 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.org

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.

GET/api/v1/plansNoEvery plan with its price, quantity and length
GET/api/v1/locationsNoCountries, cities and the products sold in each
GET/api/v1/balanceYesYour credit in USD
POST/api/v1/ordersYesBuy a plan from credit: {plan, country}
GET/api/v1/servicesYesYour plans with logins, IP lists and end dates
GET/api/v1/services/{id}YesOne plan

Errors

401unauthorizedMissing or wrong API key. Nothing is charged.
402fundsCredit is lower than the plan price. Nothing is charged.
400bad_plan / bad_countryUnknown plan, or a country the product is not sold in. Nothing is charged.
429rate_limitedMore than 300 requests a minute on one key.
503networkThe 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.