skillfed

proxyproviders

A unified interface for different proxy providers

proxyproviders v0.2.2 91.3K downloads/30d#13,521 on PyPI
Permissive 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) Active released

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 proxyproviders

uv

uv add proxyproviders

poetry

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 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

Development Status :: 3 - AlphaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3

Tags

proxy provider abstractionunified proxy apibrightdata webshare proxyproxy rotation algorithmsproxy management interfacemulti-provider proxy clientproxy selection strategies
proxy-rotationweb-scrapingmulti-provider

More WWW/HTTP packages