proxyproviders
A unified interface for different proxy providers
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later; each proxy provider requires its own API credentials (e.g., Webshare API key).
- Low install friction with a single runtime dependency (requests).
- Active maintenance status with releases through 2026.
License · maintenance · safety
permissive license (permissive) — MIT License permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
last release 2026-03-07 (160 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 91,336 downloads/mo, #13,521 on PyPI
Alternatives
Verify before relying
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))- 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.
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 on it.
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
Before you install
Low install friction with a single runtime dependency (requests). Active maintenance status with releases through 2026.
Requires Python 3.9 or later; each proxy provider requires its own API credentials (e.g., Webshare API key).
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))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 | permissive license permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagerequests |
| 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 |
| Classifiers | Development Status :: 3 - AlphaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3 |
Evidence: proxyproviders-0.2.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “proxy provider abstraction”
- proxyprovidersProvides a unified Python interface for managing proxies across…
- litellm-enterpriseLiteLLM Enterprise provides a unified Python SDK and self-hosted AI…
- litellmLiteLLM provides a unified Python interface to call 100+ LLM…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also zope.proxy · python-ipware · free-proxy · PySocks · websockets-proxy · django-ipware · django-xff · scrapingbee · pproxy · unclecode-litellm