Brand Logo
OPEN BULLET 2
Home • Pages • ProxyScrape Integration & Developer Documentation
VERIFIED POLICY Updated Nov 14, 2026

ProxyScrape Integration & Developer Documentation

/documentation

Comprehensive integration guide for cURL, Python requests, Node.js axios, and PHP with SOCKS5 tunnel setup and authentication.

ProxyScrape Quickstart & Developer Integration Guide

Everything required to connect your scraping scripts, crawlers, and browsers to our high-availability residential, mobile, and datacenter proxy networks.

Primary Gateway Hostnames & Port Specifications

Network Tier HTTP / HTTPS Gateway SOCKS5 Gateway Rotation Logic
Residential Rotating residential.proxyscrape.com:8080 socks.proxyscrape.com:1080 Per-Request or Sticky (30m)
Unlimited Residential unlimited.proxyscrape.com:8080 unlimited-socks.proxyscrape.com:1080 Unmetered Bandwidth Pool
Dedicated Datacenter datacenter.proxyscrape.com:8080 dc-socks.proxyscrape.com:1080 Static Private IP Allocation
Mobile 4G/5G Carrier mobile.proxyscrape.com:8080 mobile-socks.proxyscrape.com:1080 Carrier IP Rotation

Targeting & Rotation Username Syntax

Per-Request IP Rotation

A new exit IP is assigned on each incoming TCP connection.

username:password
Sticky Session (Up to 30 Min)

Keep the same IP across all requests using the session ID.

username-session-abc12345:password
Country Targeting

Target any of 195+ countries via ISO-2 country codes.

username-country-us:password
City Targeting

Target specific cities worldwide for localized scraping.

username-country-us-city-newyork:password

Multi-Language Integration Snippets

Python (Requests Library) pip install requests
import requests

proxy_url = "http://username:[email protected]:8080"
proxies = {
    "http": proxy_url,
    "https": proxy_url,
}

try:
    response = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=15)
    print("Connected through ProxyScrape IP:", response.json().get("ip"))
    print("Geographic Country:", response.json().get("country"))
except requests.exceptions.RequestException as err:
    print(f"Connection failed: {err}")
Node.js (Axios) npm install axios
const axios = require("axios");

async function testProxy() {
    try {
        const res = await axios.get("https://ipinfo.io/json", {
            proxy: {
                host: "residential.proxyscrape.com",
                port: 8080,
                auth: { username: "username", password: "password" }
            },
            timeout: 15000
        });
        console.log("Connected IP:", res.data.ip);
    } catch (err) {
        console.error("Error:", err.message);
    }
}
testProxy();
cURL Command Line Bash / Terminal / PowerShell
# HTTP Gateway per-request rotation
curl -x http://username:[email protected]:8080 https://ipinfo.io/json

# SOCKS5 Gateway with country targeting
curl -x socks5h://username-country-us:[email protected]:1080 https://ipinfo.io/json
PHP (cURL) Native ext-curl
$ch = curl_init("https://ipinfo.io/json");
curl_setopt($ch, CURLOPT_PROXY, "residential.proxyscrape.com:8080");
curl_setopt($ch, CURLOPT_PROXYUSERPWD, "username:password");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);

$result = curl_exec($ch);
curl_close($ch);
echo $result;
Official Support