Proxies for Python requests

Before you start

You need an active plan, your gateway credentials from the dashboard, and either your server IP whitelisted or a user and password pair. Replace USER:PASS in the examples with your real credentials.

The rotating port gives a new IP on every request. Sticky ports hold one address for the life of the session, and both live on the same host, so you choose by port rather than by product.

The gotcha worth knowing

A Session keeps the TCP connection open, so a rotating port may hand you the same address for consecutive requests on that connection. Open a new Session, or use a fresh request, when you need a guaranteed new IP each time.

Configuration

requests takes a proxies dictionary. Set both http and https to the same gateway so every scheme routes through it.

import requests

PROXY = "http://USER:PASS@gateway.proxyrotator.com:11000"
proxies = {"http": PROXY, "https": PROXY}

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

Use a Session when you want connection reuse across many requests, which is faster and lighter on the gateway:

import requests

PROXY = "http://USER:PASS@gateway.proxyrotator.com:11000"

with requests.Session() as s:
    s.proxies = {"http": PROXY, "https": PROXY}
    for _ in range(5):
        print(s.get("https://api.ipify.org").text)

Where to go next

Running more than one tool against the same gateway is normal. These cover the others.

• All integration guides, setup notes for every tool we cover
• Guides and tutorials, the concepts behind the config, including when to rotate and when not to
• cURL setup, another library or framework wired to the same gateway
• Postman setup, another library or framework wired to the same gateway
• Rotating proxies, a new IP per request, which is the default for crawling