Skip to content

A Python package to fetch usable proxies from the internet

License

Notifications You must be signed in to change notification settings

eckarthik/HideMe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HideMe Python Badge Build Status Downloads Downloads

HideMe is a python package for gathering usable proxies from free proxy webites can be installed via pip as follows.

pip install hideme

Documentation

Format of proxies returned by HideMe is as shown below

[
   {
      "ip_address":"XX.XXX.XXX.XX",
      "port":"XXXX",
      "country_code":"DE",
      "country":"Germany",
      "anonymity":"anonymous",
      "google_support":False,
      "https":False
   }
]

You can get the proxies by creating a ProxiesList object and then calling get method on that

from hideme.proxy_collector import ProxiesList
proxy_list = ProxiesList()
proxy = proxy_list.get()

Output:

[
   {
      "ip_address":"88.198.50.103",
      "port":"8080",
      "country_code":"DE",
      "country":"Germany",
      "anonymity":"anonymous",
      "google_support":False,
      "https":False
   }
]

You can restrict the required number of proxies returned by passing count param to the get method.

from hideme.proxy_collector import ProxiesList
proxies_list = ProxiesList()
proxies = proxies_list.get(count=2)

Output:

[
   {
      "ip_address":"88.198.50.103",
      "port":"8080",
      "country_code":"DE",
      "country":"Germany",
      "anonymity":"anonymous",
      "google_support":False,
      "https":False
   },
   {
      "ip_address":"187.45.123.137",
      "port":"36559",
      "country_code":"BR",
      "country":"Brazil",
      "anonymity":"elite proxy",
      "google_support":False,
      "https":True
   }
]

You can also filter out the returned proxies by passing the filter params to the ProxiesList class. Example usages:-

This will return only those proxies which are in Country - Spain

from hideme.proxy_collector import ProxiesList
proxies_list = ProxiesList(country='Spain')
proxies = proxies_list.get()

Output:

[
   {
      "ip_address":"185.44.232.30",
      "port":"53281",
      "country_code":"ES",
      "country":"Spain",
      "anonymity":"elite proxy",
      "google_support":False,
      "https":False
   },
   {
      "ip_address":"82.223.3.52",
      "port":"8118",
      "country_code":"ES",
      "country":"Spain",
      "anonymity":"elite proxy",
      "google_support":False,
      "https":False
   }
]

This will return only those proxies which are HTTPS supported

from hideme.proxy_collector import ProxiesList
proxies_list = ProxiesList(https=True)
proxies = proxies_list.get()

Output

[
   {
      "ip_address":"201.217.4.101",
      "port":"53281",
      "country_code":"PY",
      "country":"Paraguay",
      "anonymity":"elite proxy",
      "google_support":False,
      "https":True
   },
   {
      "ip_address":"13.233.160.59",
      "port":"80",
      "country_code":"IN",
      "country":"India",
      "anonymity":"elite proxy",
      "google_support":False,
      "https":True
   }
]

You can also combine multiple filter params like below

from hideme.proxy_collector import ProxiesList
proxies_list = ProxiesList(country='India',https=True,port='80',google_support=False)
proxies = proxies_list.get()

Output

[
   {
      "ip_address":"13.233.160.59",
      "port":"80",
      "country_code":"IN",
      "country":"India",
      "anonymity":"elite proxy",
      "google_support":False,
      "https":True
   }
]

About

A Python package to fetch usable proxies from the internet

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages