Skip to content
Copy-paste setup 6 languages

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.

first-request.sh bash
# 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
no client for HTTP and SOCKS5 works today
Snippets curl python node scrapy puppeteer playwright
6 quick snippets
2 auth modes
200 rotating countries
28 static countries
7 days cash back
Username/password or IP allowlist Sticky sessions via the username field Same format for HTTP, SOCKS5 and rotating

Works with your stack

Python Node.js JavaScript TypeScript Go PHP Ruby Rust C++ Kotlin Swift Selenium Scrapy cURL Pytest Docker Kubernetes GitHub PostgreSQL Redis

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 / bash http & socks5
curl -x http://user:pass@HOST:PORT https://ip.io
curl -x socks5h://user:pass@HOST:PORT https://ip.io
Python (requests) requests + PySocks
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)
Node.js socks-proxy-agent
const { SocksProxyAgent } = require("socks-proxy-agent");
const agent = new SocksProxyAgent(
  "socks5h://user:pass@HOST:PORT"
);
fetch("https://ip.io", { agent });
Scrapy settings.py
PROXY = "http://user:pass@HOST:PORT"

# or per-request in the spider:
yield Request(url, callback=parse,
              meta={"proxy": PROXY})
Puppeteer launch args
const browser = await puppeteer.launch({
  args: ["--proxy-server=http://HOST:PORT"],
});
// auth via page.authenticate({username, password})
Playwright browser.newContext
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.

session.sh bash
# 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
session id is your choice up to 30 min

Password anatomy

Static — your password, unchanged.
Rotating — Base64 JSON: country, session, rotation mode.
Dashboard — builds the string for you, copy-paste ready.

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.

Step 1

Pick one product for one target — a static IP or a small rotating allowance.

Step 2

Paste the snippet, run your real workload, watch the dashboard.

Step 3

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.