Skip to main content

Manage free and private proxies on local db for Python Projects.

Project description

Latest Travis CI build status Latest PyPI version Python versions Code Climate Test coverage Requirements Status


Manage free and private proxies on local db for Python Projects. Each proxy has a score according to how it works. Add a positive vote if the proxy works correctly and a negative vote if it does not work.

import requests
from requests.exceptions import Timeout, ConnectionError, ProxyError
from proxy_db.proxies import ProxiesList

proxy = next(ProxiesList())
    requests.get('', proxies=proxy)
except (Timeout, ConnectionError, ProxyError):

Proxy-db will return the best proxies first (more positive votes). You can also filter by country:

from proxy_db.proxies import ProxiesList

spain_proxy = next(ProxiesList('es'))
# ...

You can also filter by provider:

from proxy_db.proxies import ProxiesList

proxy_nova_proxy = next(ProxiesList(provider='Proxy Nova'))
# ...

Free proxies providers included:

  • Proxy Nova

For more information see the docs.


If you have Pip installed on your system, you can use it to install the latest ProxyDB stable version:

$ pip3 install proxy-db

Python 2.7 & 3.4-3.7 are supported but Python 3.x is recommended. Use pip2 on install for Python2. More info in the documentation

Some providers do not have the correct country for proxies. To determine the correct country proxy-db can use geoip. To use this install the optional dependencies:

$ pip3 install proxy-db[geoip]

You also need a maxmind Geolite2 license (it’s free). To obtain the license, follow these steps:

  1. Sign up for a Maxmind Geolite2 account
  2. Log in to your Maxmind account
  3. In the menu on the left, navigate to Services > My License Key.
  4. Click Generate new license key.

Sets the environment variable MAXMIND_LICENSE_KEY. To set it from Python:

import os
os.environ['MAXMIND_LICENSE_KEY'] = '28xjifHSTxVq93xZ'

HTTPS & SOCKS5 proxies

To use socks5 proxies with requests you need to install socks support:

$ pip3 install proxy-db[socks]

To use HTTPS proxies with requests/urllib3 you need to install the latests urllib3 version from sources:

$ pip install

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for proxy-db, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size proxy_db-0.3.1-py2.py3-none-any.whl (21.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size proxy-db-0.3.1.tar.gz (314.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page