Python requests with AeonProxy proxies

Protocols

HTTP and HTTPS sites over an HTTP proxy, or SOCKS5 with requests[socks]

Authentication

Login and password in the proxy URL

Rotation

A new IP per connection, or one IP per -sid- key for up to 60 minutes

Works with

Residential and mobile proxies

Before you start

• Python 3.10 or newer and pip install requests.
• Your proxy login and password from the Residential or Mobile page of the dashboard.
• Traffic on the product you use: a login without traffic gets 402.

Rotating proxy: a new IP for every connection

Put the login and password into the proxy URL and pass the same URL for http and https. The scheme stays http:// for HTTPS sites too: requests opens a CONNECT tunnel through the proxy and runs TLS with the site inside it.

import requests

proxy = "http://LOGIN-cc-us:[email protected]:7000"
proxies = {"http": proxy, "https": proxy}

for _ in range(3):
    r = requests.get("https://api.ipify.org", proxies=proxies, timeout=30)
    print(r.text)  # a different IP each time

Each requests.get() call opens its own connection, so each gets a new IP. A requests.Session keeps its connection open and sends the next request down it: in our test, three requests in one Session went through one tunnel, so a rotating login printed one IP three times. To rotate inside a Session, set s.headers["Connection"] = "close" or give each request its own -sid- key.

-cc-us asks for United States exits; leave it out for any country. Region, city and ISP keys are listed in targeting.

Sticky session: the same IP for several minutes

Add -sid- with a key of letters and digits, and -ttl- with the minutes to keep the IP (1–60, 10 if you leave it out). Every connection with that key leaves from the same IP until the time runs out; then the same login gets a new IP. The key also holds the IP when a Session's connection closes and a new one opens.

import secrets
import requests

sid = secrets.token_hex(4)  # one key per session you want to keep
proxy = f"http://LOGIN-cc-gb-sid-{sid}-ttl-30:[email protected]:7000"

s = requests.Session()
s.proxies = {"http": proxy, "https": proxy}
print(s.get("https://api.ipify.org", timeout=30).text)
print(s.get("https://api.ipify.org", timeout=30).text)  # the same IP

SOCKS5

Install the SOCKS extra with pip install "requests[socks]", use port 7001 and the socks5h:// scheme: requests then sends the host name to the proxy, which resolves it. With socks5://, requests looks the name up on your machine and sends only the IP address, so the DNS query goes out from your own connection. Over port 7000 the name always goes to the proxy in the CONNECT request.

import requests

proxy = "socks5h://LOGIN-cc-de:[email protected]:7001"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.text)

If it does not work

What every gateway code means: gateway errors.