Retrieve proxy servers.

Build Status Coverage Status PyPi Licence


Finding and storing a list of proxies can be taxing – especially ones that are free and may not work only minutes from now. proxlist will validate the proxy and return a rotating random proxy to you so you don’t need to keep a list of proxies or ensure it’s contents are still valid.

Proxies are returned in the form of strings (eg: ip:port).

These proxies come from all over the world and may not be performant for a production application. This package (for now) is intended for testing purposes and I make no guarantee about where the data sent through these proxies goes or how it’s handled. The list of proxies rotates rapidly and is free and open source.


# Install tool
pip3 install proxlist

# Install locally
make install


import proxlist
import requests

proxy = proxlist.random_proxy()

# Alternatively, you could get the entire list of configured proxies
# proxies = proxlist.list_proxies()

proxies = {
    'http': f'http://{proxy}',
    'https': f'http://{proxy}',

# Depending on the proxy and you location in the world, you may need to adjust the timeout
# to provide the proxy enough time to route your request.
response = requests.get('', proxies=proxies, timeout=15)


# Get a comprehensive list of development tools
make help


View Github