Python SDK
pip install proxyhubb — Connect intents, credentials, and pools.
pip install proxyhubb
Default API: https://api.proxyhubb.com
Buyer proxy: proxy.proxyhubb.com:8090 (override with PROXYHUBB_PROXY_ENDPOINT)
Connect (JWT)
from proxyhubb import ProxyHubClient
import requests
client = ProxyHubClient(access_token="eyJ...")
intent = client.create_session_intent("rotating", target_geo="US")
proxies = client.as_requests_proxy_from_intent(intent["token"])
print(requests.get("https://httpbin.org/ip", proxies=proxies).json())
Order credentials
creds = client.get_order_credentials("ORDER_UUID")
proxies = client.as_requests_proxy_from_credentials(creds)
print(requests.get("https://httpbin.org/ip", proxies=proxies).json())
Bulk pools (API key)
client = ProxyHubClient("phub_...")
pool = client.create_pool("scrapers", size=5)
proxies = client.as_requests_proxy(pool["id"])
Common errors
| Symptom | Fix |
|---|---|
TypeError / auth errors on intent | Construct with access_token=..., not only an API key string, for Connect |
requests hits destination without tunnel | Pass proxies= from the helper; do not omit it |
409 on credentials | Order not active — wait for escrow/session |
| SSL / proxy URL parse errors | Prefer SDK helpers over hand-built URLs with special characters |
PyPI: proxyhubb · Protocol notes: Buyer proxy