Developer Resources

Proxy Integration Guidesfor Browsers and HTTP Clients

Choose the configuration for your browser or HTTP client. Check the documented protocol and test a small request before increasing traffic.

Get API AccessView Docs

Quick Start

# Example format, not a working endpoint
http://USERNAME:PASSWORD@HOST:PORT

# Get actual credentials and routing details:
# https://agents.proxies.sx/pool/

# Select the protocol supported by your client.
# Keep credentials out of source control.

Proxy setup for browsers and workflows

Find the setting for your tool, check its scope, then test the route from the process that makes the request.

Browserless External Proxies: Setup and LimitsBrowserless browser requestsBrowserbase Custom Proxies: Settings and TestsThe new Browserbase sessionBrowser Use Proxy Settings: Local and CloudBrowser traffic, not the model APIApify Custom Proxy URLs: Actor Setup GuideRequests using the configured crawlern8n HTTP Request Proxy: Configuration GuideOne HTTP Request node

Configure the client that sends your requests

Start with the proxy configuration guide, or open the setup for your runtime.

HTTPX Proxy Setup for Python: Auth and AsyncOne HTTPX client and the requests made through itaiohttp Proxy Setup: Authentication and trust_envRequests sent with the selected aiohttp proxy configurationNode.js Fetch Proxy Setup: Environment and AuthNode default HTTP agents and the global fetch dispatcherNO_PROXY, HTTP_PROXY and HTTPS_PROXY ExplainedOnly clients that read the selected process environmentDocker Proxy Setup: Containers, Builds and PullsContainer, build or daemon settings depending on the request

When a request fails, the proxy troubleshooting guide maps the error to the layer that produced it. Start with the gateway error codes, or with ERR_TUNNEL_CONNECTION_FAILED for browser automation.

Choose Your Framework

Click any card for detailed setup instructions and code examples.

Playwright

Cross-browser automation with native proxy support.

View Guide

Puppeteer

Chrome DevTools Protocol for headless automation.

View Guide

Selenium

Industry-standard browser automation suite.

View Guide

Python Requests

Simple HTTP library for Python developers.

View Guide

Node.js / Axios

HTTP clients for JavaScript/TypeScript.

View Guide

Scrapy

Professional web scraping framework.

View Guide

cURL

Command-line HTTP client for quick testing.

View Guide

More Coming

Go, Rust, PHP, Ruby, and more

Supported Proxy Formats

SOCKS5 (Recommended)

socks5://psx_YOUR_ID-peer-us:PROXY_PASSWORD@gw.proxies.sx:7001

# DNS resolution through proxy (socks5h)
socks5h://psx_YOUR_ID-peer-us:PROXY_PASSWORD@gw.proxies.sx:7001

# Sticky session (pins one device)
socks5h://psx_YOUR_ID-peer-us-sid-job1-rot-sticky:PROXY_PASSWORD@gw.proxies.sx:7001

Best for: Browser automation, full TCP support, DNS privacy

HTTP/HTTPS

http://psx_YOUR_ID-peer-us:PROXY_PASSWORD@gw.proxies.sx:7000

# HTTPS targets use the same proxy URL (CONNECT)
http://psx_YOUR_ID-peer-us:PROXY_PASSWORD@gw.proxies.sx:7000

# URL-encoded special characters in the password
http://psx_YOUR_ID-peer-us:p%40ss@gw.proxies.sx:7000

Best for: HTTP libraries, simple requests, legacy systems

Common Integration Patterns

Environment Variables

Set HTTP_PROXY and HTTPS_PROXY in your shell or .env file for automatic proxy usage.

export HTTP_PROXY=socks5://...
export HTTPS_PROXY=socks5://...

Session-Based

Create a session object with proxy config for connection reuse and better performance.

session.proxies = {
  "http": proxy,
  "https": proxy
}

Per-Request

Pass proxy config with each request for maximum control and rotation.

requests.get(url, proxies={
  "https": get_next_proxy()
})

Developer-Friendly Features

Low Latency

Optimized routing for minimal response time overhead.

TLS Support

Full HTTPS support with proper certificate handling.

Sticky Sessions

Maintain same IP across requests with session IDs.

Many countries

Target specific geos with country-specific ports.

Start Building Today

Get your API credentials and start integrating mobile proxies in minutes.

Get StartedRead Documentation