---
id: proxyproviders
version: "0.2.2"
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)
license_treatment: permissive
maintenance: active
---

# proxyproviders — A unified interface for different proxy providers

License: permissive · Maintenance: active · Downloads: 91.3K/mo

## 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 above — 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

pip install proxyproviders
uv add proxyproviders
poetry add proxyproviders

## Installing 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_current
- Install friction: low
- Maintenance: active
- Downloads: 91.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

proxy provider abstraction, unified proxy api, brightdata webshare proxy, proxy rotation algorithms, proxy management interface, multi-provider proxy client, proxy selection strategies, proxy-rotation, web-scraping, multi-provider

[View on SkillFed](https://skillfed.io/packages/proxyproviders) · [View on PyPI](https://pypi.org/project/proxyproviders/)