Skip to main content

Proxy scraper for further use

Project description


Get free working proxy from and use it in your script

FreeProxy class scrapes proxies from and checkes if proxy is working. There is posibility to
filter proxies by country and acceptable timeout. You can also randomize list of proxies from where script would get
first working proxy.

You can use it in sending request through custom proxy, with selenium or wherever you want.

Returns proxy as string:



  • Python3

  • Request library

  • Lxml library


pip install free-proxy


Usage with examples

First import Free Proxy that way:

from fp.fp import FreeProxy


Parameter Type Example Default value
country_id list ['US', 'BR'] None
timeout float > 0 0.1 0.5
rand bool True False
proxy = FreeProxy().get()  
  • country_id parameter
    Get first working proxy from specified list of countries. If there is no valid proxy from specified list check all countries
proxy = FreeProxy(country_id=['US', 'BR']).get()  
  • timeout parameter
    Timeout is parameter for checking if proxy is valid. If test site doesn't respond in specified time
    script marks this proxy as invalid. Default timeout=0.5. You can change it by defining
    specified timeout eg. timeout=1.
proxy = FreeProxt(timeout=1).get()  
  • rand parameter
proxy = FreeProxy(rand=True).get()  

Shuffles proxy list from Default rand=False and searches for working proxy from newest to oldest (as they are listed in

You can combine parameters:

proxy = FreeProxy(country_id=['US', 'BR'], timeout=0.3, rand=True).get()  

If there is no working proxy script returns None


[1.0.1] - 2020-03-19


  • Fix typos in readme
  • Fix urrlib3 exception urllib3.exceptions.ProxySchemeUnknown: Not supported proxy scheme None,
  • Fix imports



Free Software!

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 free-proxy, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size free_proxy-1.0.1-py3-none-any.whl (4.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size free_proxy-1.0.1.tar.gz (3.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page