INTLanguages & Libraries

How to Use KnoxProxy with Python Requests

The most popular Python HTTP library. Configure KnoxProxy residential, datacenter, or mobile proxies with two lines of code.

2 minutes setupVerified against Python Requests · Jul 2026 · requests 2.32.xLanguage: Python

01Steps

Configure Python Requests

Install requests

Install the requests library from PyPI.

python

pip install requests

Set your proxy credentials

Use your KnoxProxy dashboard username and password in the proxy URL.

python

PROXY_USER = "your_username"
PROXY_PASS = "your_password"
proxy_url = f"http://{PROXY_USER}:{PROXY_PASS}@gw.knoxproxy.com:7000"

Make a proxied request

Pass the proxy URL as a dict to the proxies parameter.

python

import requests

proxies = {
    "http": proxy_url,
    "https": proxy_url,
}
response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())

Add geo-targeting

Target a specific country by adding it to your username string.

python

# Country targeting via username flag
proxy_url = f"http://{PROXY_USER}-country-us:{PROXY_PASS}@gw.knoxproxy.com:7000"

# Or via header
response = requests.get("https://httpbin.org/ip",
    proxies=proxies,
    headers={"X-KnoxProxy-Country": "us"})

Configure rotation

Each request gets a fresh IP by default. Use session IDs for sticky sessions.

python

# Sticky session (same IP for up to 30 min)
proxy_url = f"http://{PROXY_USER}-session-abc123:{PROXY_PASS}@gw.knoxproxy.com:7000"

Test your connection

Verify the proxy is working by checking your exit IP.

python

response = requests.get("https://httpbin.org/ip", proxies=proxies, timeout=30)
print(f"Exit IP: {response.json()['origin']}")
print(f"Status: {response.status_code}")

02Values

Copy-paste config

knoxproxy_requests.py

"""KnoxProxy + Python requests -- complete working example."""
import requests

PROXY_USER = "your_username"
PROXY_PASS = "your_password"
PROXY_HOST = "gw.knoxproxy.com"
PROXY_PORT = 7000

proxy_url = f"http://{PROXY_USER}:{PROXY_PASS}@{PROXY_HOST}:{PROXY_PORT}"
proxies = {"http": proxy_url, "https": proxy_url}

# Basic request with rotation (new IP each time)
response = requests.get(
    "https://httpbin.org/ip",
    proxies=proxies,
    timeout=30,
)
print(f"Exit IP: {response.json()['origin']}")

# Country-targeted request
us_proxy = f"http://{PROXY_USER}-country-us:{PROXY_PASS}@{PROXY_HOST}:{PROXY_PORT}"
response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": us_proxy, "https": us_proxy},
    timeout=30,
)
print(f"US IP: {response.json()['origin']}")

# Sticky session (same IP for multiple requests)
session_proxy = f"http://{PROXY_USER}-session-mysession1:{PROXY_PASS}@{PROXY_HOST}:{PROXY_PORT}"
session = requests.Session()
session.proxies = {"http": session_proxy, "https": session_proxy}
for i in range(3):
    r = session.get("https://httpbin.org/ip", timeout=30)
    print(f"Request {i+1}: {r.json()['origin']}")

Rotation config

Default: new IP per request. For sticky sessions, append `-session-{id}` to your username. Sessions last up to 30 minutes for residential, 60 minutes for mobile.

Python Requests integration troubleshooting guide
Problem	Fix
ProxyError: Cannot connect to proxy	Verify gateway is gw.knoxproxy.com:7000. Check your firewall allows outbound TCP on port 7000.
407 Proxy Authentication Required	Check credentials in your KnoxProxy dashboard. Make sure username and password are URL-encoded if they contain special characters.
ConnectTimeout after 30s	Increase timeout to 60s. If persistent, try a different proxy type or contact support.
SSLError: certificate verify failed	Update certifi: pip install --upgrade certifi. Do not use verify=False in production.

Before you start

Prerequisites

Python 3.8 or newer installed

pip install requests

A KnoxProxy account with active proxy credentials

Authentication

Auth method comparison

Username:PasswordRecommendedWorks everywhere, no IP allowlisting needed, rotate credentials per worker. Credentials in code or env vars

IP AllowlistNo credentials in code, simpler proxy URL. Requires static server IP, one allowlist per account

All routing lives in the username

Anatomy of the credential string

USER-country-de-city-berlin-session-profile07

country-de -- geo, firstcity-berlin -- optional city pinsession-profile07 -- unique per Python Requests profile

Order matters -- geo flags before the session flag. The session name is free text; use the profile ID so the mapping is self-documenting. Password stays as issued; no flags belong there. HTTP on :7000, SOCKS5 on :7001, same credentials.

Failure modes & fixes

ProxyError: Cannot connect to proxy -- Wrong gateway host or port, or firewall blocking outbound connections on port 7000.
407 Proxy Authentication Required -- Invalid username or password.
ConnectTimeout after 30s -- Target site is slow or the proxy gateway is under load.
SSLError: certificate verify failed -- The proxy is intercepting HTTPS incorrectly or your CA bundle is outdated.

Verify before you trust it

IP checker confirms country and ASN match your target
Response status is 200, not 403 or 407
No repeated timeouts on the first few requests
Rotation or stickiness behaves as configured

FAQ

Python Requests + KnoxProxy, answered

Does Python requests support SOCKS5 with KnoxProxy?

Yes. Install requests[socks] (pip install requests[socks]) and use socks5://USER:PASS@gw.knoxproxy.com:7001 as the proxy URL. SOCKS5 is available on all proxy types.

How do I rotate IPs with Python requests?

Each new request.get() call through the gateway automatically gets a fresh IP. For sticky sessions, append -session-{id} to your username to hold the same IP for up to 30 minutes.

Can I use async requests with KnoxProxy?

requests is synchronous. For async, use aiohttp or httpx with asyncio. Both work with KnoxProxy using the same proxy URL format.

What is the maximum concurrency with Python requests?

KnoxProxy allows unlimited concurrent connections on all plans. Your limit is your machine and the target site, not the proxy. Use concurrent.futures.ThreadPoolExecutor for parallelism with requests.

RELMore integrations

Start using Python Requests with KnoxProxy

Free trial on rotating residential -- 2 minutes setup, no credit card.

Start for free See pricing

Configure Python Requests

Install requests

Install the requests library from PyPI.

python

pip install requests

Set your proxy credentials

Use your KnoxProxy dashboard username and password in the proxy URL.

python

PROXY_USER = "your_username"
PROXY_PASS = "your_password"
proxy_url = f"http://{PROXY_USER}:{PROXY_PASS}@gw.knoxproxy.com:7000"

Make a proxied request

Pass the proxy URL as a dict to the proxies parameter.

python

import requests

proxies = {
    "http": proxy_url,
    "https": proxy_url,
}
response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())

Add geo-targeting

Target a specific country by adding it to your username string.

python

# Country targeting via username flag
proxy_url = f"http://{PROXY_USER}-country-us:{PROXY_PASS}@gw.knoxproxy.com:7000"

# Or via header
response = requests.get("https://httpbin.org/ip",
    proxies=proxies,
    headers={"X-KnoxProxy-Country": "us"})

Configure rotation

Each request gets a fresh IP by default. Use session IDs for sticky sessions.

python

# Sticky session (same IP for up to 30 min)
proxy_url = f"http://{PROXY_USER}-session-abc123:{PROXY_PASS}@gw.knoxproxy.com:7000"

Test your connection

Verify the proxy is working by checking your exit IP.

python

response = requests.get("https://httpbin.org/ip", proxies=proxies, timeout=30)
print(f"Exit IP: {response.json()['origin']}")
print(f"Status: {response.status_code}")

Copy-paste config

knoxproxy_requests.py

"""KnoxProxy + Python requests -- complete working example."""
import requests

PROXY_USER = "your_username"
PROXY_PASS = "your_password"
PROXY_HOST = "gw.knoxproxy.com"
PROXY_PORT = 7000

proxy_url = f"http://{PROXY_USER}:{PROXY_PASS}@{PROXY_HOST}:{PROXY_PORT}"
proxies = {"http": proxy_url, "https": proxy_url}

# Basic request with rotation (new IP each time)
response = requests.get(
    "https://httpbin.org/ip",
    proxies=proxies,
    timeout=30,
)
print(f"Exit IP: {response.json()['origin']}")

# Country-targeted request
us_proxy = f"http://{PROXY_USER}-country-us:{PROXY_PASS}@{PROXY_HOST}:{PROXY_PORT}"
response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": us_proxy, "https": us_proxy},
    timeout=30,
)
print(f"US IP: {response.json()['origin']}")

# Sticky session (same IP for multiple requests)
session_proxy = f"http://{PROXY_USER}-session-mysession1:{PROXY_PASS}@{PROXY_HOST}:{PROXY_PORT}"
session = requests.Session()
session.proxies = {"http": session_proxy, "https": session_proxy}
for i in range(3):
    r = session.get("https://httpbin.org/ip", timeout=30)
    print(f"Request {i+1}: {r.json()['origin']}")

Rotation config

Default: new IP per request. For sticky sessions, append `-session-{id}` to your username. Sessions last up to 30 minutes for residential, 60 minutes for mobile.

Python Requests integration troubleshooting guide
Problem	Fix
ProxyError: Cannot connect to proxy	Verify gateway is gw.knoxproxy.com:7000. Check your firewall allows outbound TCP on port 7000.
407 Proxy Authentication Required	Check credentials in your KnoxProxy dashboard. Make sure username and password are URL-encoded if they contain special characters.
ConnectTimeout after 30s	Increase timeout to 60s. If persistent, try a different proxy type or contact support.
SSLError: certificate verify failed	Update certifi: pip install --upgrade certifi. Do not use verify=False in production.

How to Use KnoxProxy with Python Requests

Configure Python Requests

Copy-paste config

Prerequisites

Auth method comparison

Anatomy of the credential string

Failure modes & fixes

Verify before you trust it

Python Requests + KnoxProxy, answered

Related tools

Start using Python Requests with KnoxProxy

How to Use KnoxProxy with Python Requests

Configure Python Requests

Copy-paste config

Prerequisites

Auth method comparison

Anatomy of the credential string

Failure modes & fixes

Verify before you trust it

Python Requests + KnoxProxy, answered

Related tools

Start using Python Requests with KnoxProxy