Setup Guides: One Line, Any Stack
Every ProxyPerk endpoint speaks a standard proxy URL. These guides show the one-line change for curl, Python, Node, Scrapy, Puppeteer and Playwright — plus how sticky sessions actually work.
# the whole setup, one line
$ curl -x http://user:pass@HOST:PORT \
https://ip.io
# socks5, same shape
$ curl -x socks5h://user:pass@HOST:PORT \
https://ip.io
Works with your stack
Snippets
The One-Line Change
Replace HOST, PORT, user and pass with the values in your dashboard. That is the entire integration — no SDK, no agent, no special build.
curl -x http://user:pass@HOST:PORT https://ip.io
curl -x socks5h://user:pass@HOST:PORT https://ip.io
import requests
proxies = {
"http": "http://user:pass@HOST:PORT",
"https": "http://user:pass@HOST:PORT",
}
r = requests.get("https://ip.io", proxies=proxies)
print(r.text)
const { SocksProxyAgent } = require("socks-proxy-agent");
const agent = new SocksProxyAgent(
"socks5h://user:pass@HOST:PORT"
);
fetch("https://ip.io", { agent });
PROXY = "http://user:pass@HOST:PORT"
# or per-request in the spider:
yield Request(url, callback=parse,
meta={"proxy": PROXY})
const browser = await puppeteer.launch({
args: ["--proxy-server=http://HOST:PORT"],
});
// auth via page.authenticate({username, password})
const browser = await chromium.launch({
proxy: {
server: "http://HOST:PORT",
username: "user",
password: "pass",
},
});
Sticky sessions
Same IP, On Purpose
A rotating pool gives a new exit per request by default. Append a session id to the username and the same exit IP is held for that session, so a login or a multi-step flow stays on one address.
No session id
Every request gets a new exit. Use it for broad crawling.
With session id
Same exit for the sticky window. Use it for logins and multi-step flows.
Two auth modes
Username and password, an IP allowlist, or both at once.
Country in password
Rotating settings travel Base64-packed inside the proxy password.
# per-request rotation
$ curl -x http://user:pass@HOST:PORT ip.io
→ new IP each call
# sticky, 30 min window
$ curl -x http://user-abc123:pass@HOST:PORT ip.io
→ same IP while abc123 lives
Password anatomy
Guarantee
Test It Before You Trust It
A snippet is not proof. Buy the smallest thing that tests the connection in your own stack, then measure it.
Pick one product for one target — a static IP or a small rotating allowance.
Paste the snippet, run your real workload, watch the dashboard.
Not delivered or not as described? Open a dashboard ticket within 7 days.
Every ProxyPerk product carries a 7-day instant cash back guarantee — datacenter included, and datacenter IPs are additionally trial-eligible for one hour. Once support confirms the request, the refund is processed straight away, with no retention call.
Covers non-delivery and service issues. Third-party software incompatibility, prohibited uses and used service are excluded — Refund Policy.
Help center
Setup questions
The questions that come up in the first five minutes.
Need the raw endpoint reference? See the API documentation or the FAQ.