Integrations

Proxy setup & integrations

Copy-paste examples for HTTP and SOCKS proxies. Replace placeholders with the host, port, username, and password from your active plan in the dashboard.

Dashboard is source of truth HTTP & SOCKS5

1. Get your credentials

STEP 1

Purchase a plan

Choose Budget Residential, Subscription, Premium Geo, IPv4 Unlimited, or IPv6 plans from pricing pages.

STEP 2

Open your pack

Go to Dashboard → select the product → open the active pack / endpoint builder.

STEP 3

Copy & test

Paste into your stack below, then verify with our Proxy Checker or IP Checker.

Placeholders: HOST, PORT, USERNAME, PASSWORD. Sticky session and geo parameters are appended to the username on many residential plans — use the exact string from your dashboard.

2. Connection formats

Standard proxy URLs (HTTP CONNECT or SOCKS5 depending on plan):

HTTP / HTTPS

http://USERNAME:PASSWORD@HOST:PORT

SOCKS5

socks5://USERNAME:PASSWORD@HOST:PORT

Using requests (install: pip install requests):

Python

import requests

proxies = {
    "http": "http://USERNAME:PASSWORD@HOST:PORT",
    "https": "http://USERNAME:PASSWORD@HOST:PORT",
}

r = requests.get(
    "https://api.ipify.org?format=json",
    proxies=proxies,
    timeout=30,
)
print(r.json())

For SOCKS5, use a socks handler (pip install requests[socks]) or httpx with a SOCKS proxy URL.

cURL

curl -x "http://USERNAME:PASSWORD@HOST:PORT" \
  -H "User-Agent: ChillyProxy-Test/1.0" \
  "https://api.ipify.org?format=json"

Node 18+ with undici ProxyAgent:

Node.js

import { ProxyAgent, fetch } from "undici";

const proxyUrl = "http://USERNAME:PASSWORD@HOST:PORT";
const agent = new ProxyAgent(proxyUrl);

const res = await fetch("https://api.ipify.org?format=json", {
  dispatcher: agent,
});
console.log(await res.json());

Puppeteer / Playwright: set --proxy-server=HOST:PORT and authenticate with username/password in launch options.

Chrome / Edge: Settings → System → Open proxy settings → Manual proxy → enter HOST and PORT → save; when browsing, enter USERNAME and PASSWORD when prompted.
Firefox: Settings → Network Settings → Manual proxy configuration.
Extensions: Proxy switcher extensions can store credentials; prefer OS-level or app-level config for automation tools.
Sticky sessions: Append session parameters to the username exactly as shown on your plan page (country/state/city suffixes vary by product).

3. Notes by product type

Product	Protocol	Tips
Budget / Premium Residential	HTTP, SOCKS5	Rotate vs sticky via username parameters from endpoint builder.
Subscription packs	HTTP	Traffic counted in GB; monitor usage in dashboard.
Premium Geo	HTTP	Country targeting encoded in credentials — do not guess suffixes.
IPv4 Unlimited	HTTP / SOCKS	Speed tier shown at purchase; fair-use applies per plan page.
Residential / Datacenter IPv6	HTTP / SOCKS	IPv6 targets require IPv6-capable client and destinations.

4. Reseller API

Approved resellers provision sub-users and plans via authenticated JSON API. API keys and base URL are available after login:

Reseller API settings — keys, permissions, IP allowlist.
Reseller program — apply if you are not yet a partner.

Example request shape

POST /api/reseller/... 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{ "plan": "...", "traffic_gb": 1 }

Exact endpoints and payloads are documented in the reseller panel; do not share API keys in tickets or public channels.

5. Troubleshooting

407 / auth errors: Username/password mismatch or expired pack — regenerate from dashboard.
Timeouts: Increase client timeout; check firewall allows outbound to HOST:PORT.
Wrong country: Update geo/session segment in username per endpoint builder.
Traffic not counting: Confirm you are routing through the proxy (check IP with tools above).

FAQ Contact support Legal hub