proxyproviders
A unified interface for different proxy providers
What it is and what it does
ProxyProviders is a Python wrapper that abstracts away the differences between multiple proxy service APIs—BrightData, WebShare, and others—behind a single, consistent interface. Instead of learning each provider's API separately, you instantiate a provider object with credentials, call methods like `get_proxy()` and `list_proxies()`, and get back standardized proxy objects that can be formatted for use with requests or other HTTP clients.
The package includes built-in proxy selection algorithms (RoundRobin, Random, First) and supports custom algorithms for advanced use cases like geographic filtering. It caches proxy lists with configurable refresh intervals and lets you pass provider-specific parameters when needed. The main appeal is provider agnosticism: you can write code that accepts a generic ProxyProvider interface and swap implementations without changing your logic.
Use it for:
- Web scraping with rotating proxies to avoid IP bans and distribute requests across multiple endpoints.
- Load testing or stress testing where you need to simulate traffic from many different IP addresses.
- Switching between proxy providers (e.g., BrightData for residential, WebShare for datacenter) without rewriting client code.
- Building a proxy abstraction layer in a larger scraping or automation framework that supports multiple backends.
- Implementing custom proxy selection logic (e.g., prefer US-based proxies) via the Algorithm interface.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides a unified Python interface for managing proxies across multiple providers including BrightData and WebShare, with support for proxy selection algorithms and format conversion.
Yes, if you need to work with multiple proxy providers or want a clean abstraction over proxy management. The low install friction, permissive license, active maintenance, and lack of known vulnerabilities make it a safe choice. Start with it if you're already using requests and a supported proxy service; skip it if you only need a single provider's native SDK.
Install
proxyproviders on PyPI
pip
pip install proxyprovidersuv
uv add proxyproviderspoetry
poetry add proxyprovidersInstalling proxyproviders
Before you install
Low install friction with a single runtime dependency (requests). Active maintenance status with releases through 2026.
License in practice
MIT License permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
Quickstart
pip install proxyproviders
from proxyproviders import Webshare
from proxyproviders.models.proxy import ProxyFormat
import requests
provider = Webshare(api_key="your-api-key")
proxy = provider.get_proxy()
response = requests.get("https://httpbin.org/ip", proxies=proxy.format(ProxyFormat.REQUESTS))
Requires Python 3.9 or later; each proxy provider requires its own API credentials (e.g., Webshare API key).
Verify before relying
- Whether all supported providers (beyond BrightData and WebShare) are documented and stable.
- Performance characteristics when managing large proxy pools or high-frequency rotation.
- Timeout and retry behavior when a proxy provider API is unavailable.
Package facts
| License | MIT License Copyright (c) 2025 David Teather Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record) (permissive) |
| Python support | supports the current Python release (>=3.9) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 1 — requests |
| Maintenance | actively maintained — 160 days since the last release |
| First released | |
| Downloads | 91,336/month — #13,521 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: proxyproviders-0.2.2-py3-none-any.whl
Tags
More WWW/HTTP packages
urllib3 is an HTTP client library that provides…
permissive · top 100 on PyPI
requestsRequests is a Python HTTP library that…
permissive · top 100 on PyPI
h11h11 is a pure-Python HTTP/1.1 protocol…
permissive · top 100 on PyPI
httpxHTTPX is a fully featured HTTP client library…
permissive · top 100 on PyPI
httpcoreA minimal low-level HTTP client library that…
permissive · top 100 on PyPI
aiohttpaiohttp is an async HTTP client and server…
permissive · top 100 on PyPI
zope.proxyzope.proxy provides transparent wrapper objects…
unclear · top 15,000 on PyPI
python-ipwareExtracts a client's IP address from web request…
permissive · top 5,000 on PyPI
PySocksPySocks provides a SOCKS and HTTP proxy client…
permissive · top 1,000 on PyPI
websockets-proxyEnables WebSocket connections through HTTP and…
permissive · top 15,000 on PyPI
django-ipwareRetrieves the client's IP address from a Django…
permissive · top 5,000 on PyPI
django-xffDjango middleware that extracts the real client…
permissive · top 15,000 on PyPI
scrapingbeePython SDK wrapper for ScrapingBee's web…
permissive · top 15,000 on PyPI
pproxypproxy is an asynchronous proxy server that…
permissive · top 15,000 on PyPI
unclecode-litellmUnified Python interface to call many LLM…
permissive · top 5,000 on PyPI