Integration guides

Proxy integration guides

How to connect ProxySup proxies to popular tools, organized by tool. Every guide uses the same gateway and username rules.

Create accountSee use cases

Shared connection settings

Connected

Country
United States, New York
Product
Residential
Session
Sticky, up to 30 min
Gateway
gate.proxysup.com:7777

Username

user-country-us-city-new_york-session-a1b2

Example response

{ "ip": "203.0.113.24",
  "country": "US",
  "city": "new york" }
  • 3 tool guides
  • 4 languages in code examples
  • Up to 30 min sticky sessions
  • HTTP, HTTPS, SOCKS5

Guides

How to connect the proxy, by tool

  • Using a proxy with Python requests

    requests is one of the most used libraries for sending web requests in Python. Put the ProxySup gateway address in proxies and it connects right away.

    View guide

  • Connecting a proxy to Playwright

    Playwright is a tool for driving a browser with code. Put the gateway, username and token in the proxy option when you launch the browser, and every page request goes through ProxySup.

    View guide

  • Connecting a proxy to Scrapy

    Scrapy is a Python tool for building crawlers that collect many pages. Put proxy in the request meta and every request goes through ProxySup.

    View guide

Common

The same connection details for every tool

With three things, the gateway, the username and the token, you can connect from any tool.

Gatewaygate.proxysup.com:7777
country-CODESets the country to connect from
city-CITYSets the city too. Only in countries with city targeting
session-NAMETurns on a sticky session. The same name gets the same IP
type-mobile or type-dcSwitches to mobile or datacenter proxies. Without it, residential is used
PasswordYour account access token
curl -x gate.proxysup.com:7777 \
  -U "user-country-us:YOUR_TOKEN" \
  https://ipinfo.io/json
import requests

proxy = "http://user-country-us:[email protected]:7777"
res = requests.get("https://ipinfo.io/json",
                   proxies={"http": proxy, "https": proxy})
print(res.json())
import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://user-country-us:[email protected]:7777");
const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());
$ch = curl_init("https://ipinfo.io/json");
curl_setopt($ch, CURLOPT_PROXY, "gate.proxysup.com:7777");
curl_setopt($ch, CURLOPT_PROXYUSERPWD, "user-country-us:YOUR_TOKEN");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);

Tools

Tools you can connect the proxy to

Most tools that let you enter a proxy address connect as they are.

You get an access token as soon as you sign up

Get your token and top up your balance to use the code in the guides as is.

Create accountSee pricing