<h1 align="center"> pyfreeproxies </h1>
<p align="center">
<!--
<a href="https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-test.yml"><img src="https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-test.yml/badge.svg" alt="Python Test"/></a>
-->
<a href="https://github.com/Simatwa/pyfreeproxies/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/static/v1?logo=GPL&color=Blue&message=GNUv3&label=License"/></a>
<a href=""><img alt="Python version" src="https://img.shields.io/pypi/pyversions/pyfreeproxies"/></a>
<a href="https://pypi.org/project/pyfreeproxies"><img alt="PyPi" src="https://img.shields.io/pypi/v/pyfreeproxies?color=green"/></a>
<a href="https://github.com/psf/black"><img alt="Black" src="https://img.shields.io/badge/code%20style-black-000000.svg"/></a>
<a href="https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-package.yml"><img alt="Python Package flow" src="https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-package.yml/badge.svg?branch=master"/></a>
<a href="https://pepy.tech/project/pyfreeproxies"><img src="https://static.pepy.tech/personalized-badge/pyfreeproxies?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" alt="Downloads"></a>
<a href="https://hits.seeyoufarm.com"><img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com/Simatwa/pyfreeproxies"/></a>
<a href="https://wakatime.com/badge/github/Simatwa/pyfreeproxies"><img src="https://wakatime.com/badge/github/Simatwa/pyfreeproxies.svg" alt="wakatime"></a>
</p>
> Free to use http, socks4 and socks5 proxies based on [free-proxies](https://github.com/Simatwa/free-proxies).
## Installation
```
pip install -U pyfreeproxies
```
## Usage
1. FreeProxies
```python
from pyfreeproxies import FreeProxies
proxy = FreeProxies()
proxy.get_http_proxies() # http proxies
proxy.get_socks4_proxies() # socks4 proxies
proxy.get_socks5_proxies() # socks 5 proxies
proxy.get_combined_proxies() # http, socks4, socks5 combined.
proxy.get_random_proxies() # Select from the lists randomly. proxy.get_confirmed_working_proxies() # list of functional tested proxies
proxy.get_proxies_metadata({"country": "United States",}) # filter with proxy metadata keys.
proxy.proxies_update_available # check if there's an update to proxies.
```
2. IP Metadata
```python
from pyfreeproxies import FreeProxies
import pyfreeproxies.utils as proxies_util
http_proxies = FreeProxies().get_socks4_proxies()
proxy_metadata = proxies_util.trace_ip(http_proxies[0])
print(proxy_metadata) # <class 'pyfreeproxies.models.ProxyMetadataModel'>
"""
status='success' country='Vietnam' countryCode='VN' region='CT' regionName='Can Tho' city='Can Tho' zip='' lat=10.0359 lon=105.7808 timezone='Asia/Ho_Chi_Minh' isp='Viettel Corporation' org='VIETEL' as_='AS7552 Viettel Group' query='171.248.211.25' response_time=None continent=None continentCode=None district=None offset=None currency=None asname=None reverse=None mobile=None proxy=None hosting=None
"""
```
3.
Raw data
{
"_id": null,
"home_page": "https://github.com/Simatwa/pyfreeproxies",
"name": "pyfreeproxies",
"maintainer": "Smartwa",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "freeproxies, proxies, socks4, socks5, http",
"author": "Smartwa",
"author_email": "simatwacaleb@proton.me",
"download_url": "https://files.pythonhosted.org/packages/fc/c5/3e75e31808acaf195fc37bde7b307ac3ca838243d75d22212fb53a6094bb/pyfreeproxies-0.2.3.tar.gz",
"platform": null,
"description": "<h1 align=\"center\"> pyfreeproxies </h1>\n<p align=\"center\">\n<!--\n<a href=\"https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-test.yml\"><img src=\"https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-test.yml/badge.svg\" alt=\"Python Test\"/></a>\n-->\n<a href=\"https://github.com/Simatwa/pyfreeproxies/blob/main/LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/static/v1?logo=GPL&color=Blue&message=GNUv3&label=License\"/></a>\n<a href=\"\"><img alt=\"Python version\" src=\"https://img.shields.io/pypi/pyversions/pyfreeproxies\"/></a>\n<a href=\"https://pypi.org/project/pyfreeproxies\"><img alt=\"PyPi\" src=\"https://img.shields.io/pypi/v/pyfreeproxies?color=green\"/></a>\n<a href=\"https://github.com/psf/black\"><img alt=\"Black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"/></a>\n<a href=\"https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-package.yml\"><img alt=\"Python Package flow\" src=\"https://github.com/Simatwa/pyfreeproxies/actions/workflows/python-package.yml/badge.svg?branch=master\"/></a>\n<a href=\"https://pepy.tech/project/pyfreeproxies\"><img src=\"https://static.pepy.tech/personalized-badge/pyfreeproxies?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads\" alt=\"Downloads\"></a>\n<a href=\"https://hits.seeyoufarm.com\"><img src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com/Simatwa/pyfreeproxies\"/></a> \n<a href=\"https://wakatime.com/badge/github/Simatwa/pyfreeproxies\"><img src=\"https://wakatime.com/badge/github/Simatwa/pyfreeproxies.svg\" alt=\"wakatime\"></a>\n</p>\n\n> Free to use http, socks4 and socks5 proxies based on [free-proxies](https://github.com/Simatwa/free-proxies).\n\n## Installation\n\n```\npip install -U pyfreeproxies\n```\n\n## Usage \n\n1. FreeProxies\n\n ```python\n from pyfreeproxies import FreeProxies\n proxy = FreeProxies()\n proxy.get_http_proxies() # http proxies\n proxy.get_socks4_proxies() # socks4 proxies\n proxy.get_socks5_proxies() # socks 5 proxies\n proxy.get_combined_proxies() # http, socks4, socks5 combined.\n proxy.get_random_proxies() # Select from the lists randomly. proxy.get_confirmed_working_proxies() # list of functional tested proxies\n proxy.get_proxies_metadata({\"country\": \"United States\",}) # filter with proxy metadata keys.\n proxy.proxies_update_available # check if there's an update to proxies.\n ```\n\n2. IP Metadata\n\n ```python\n from pyfreeproxies import FreeProxies\n import pyfreeproxies.utils as proxies_util\n http_proxies = FreeProxies().get_socks4_proxies()\n proxy_metadata = proxies_util.trace_ip(http_proxies[0])\n print(proxy_metadata) # <class 'pyfreeproxies.models.ProxyMetadataModel'>\n \"\"\"\n status='success' country='Vietnam' countryCode='VN' region='CT' regionName='Can Tho' city='Can Tho' zip='' lat=10.0359 lon=105.7808 timezone='Asia/Ho_Chi_Minh' isp='Viettel Corporation' org='VIETEL' as_='AS7552 Viettel Group' query='171.248.211.25' response_time=None continent=None continentCode=None district=None offset=None currency=None asname=None reverse=None mobile=None proxy=None hosting=None\n \"\"\"\n ```\n\n3. \n",
"bugtrack_url": null,
"license": "GNUv3",
"summary": "Free to use http, socks4 and socks5 proxies",
"version": "0.2.3",
"project_urls": {
"Bug Report": "https://github.com/Simatwa/pyfreeproxies/issues/new",
"Documentation": "https://github.com/Simatwa/pyfreeproxies/blob/main/docs",
"Download": "https://github.com/Simatwa/pyfreeproxies/releases",
"Homepage": "https://github.com/Simatwa/pyfreeproxies",
"Issue Tracker": "https://github.com/Simatwa/pyfreeproxies/issues",
"Source Code": "https://github.com/Simatwa/pyfreeproxies"
},
"split_keywords": [
"freeproxies",
" proxies",
" socks4",
" socks5",
" http"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "beb7d2322849352aa92c79181825d317d973656493429b6a6db68ffca1bf1ca9",
"md5": "02aef1ebe7b7f81547b71face2b204e6",
"sha256": "fd5f6cb6f2c30ceae5fda69f1484c95adb1bae5cee1938676de521c559ef1dac"
},
"downloads": -1,
"filename": "pyfreeproxies-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "02aef1ebe7b7f81547b71face2b204e6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 19861,
"upload_time": "2025-10-22T09:54:44",
"upload_time_iso_8601": "2025-10-22T09:54:44.509659Z",
"url": "https://files.pythonhosted.org/packages/be/b7/d2322849352aa92c79181825d317d973656493429b6a6db68ffca1bf1ca9/pyfreeproxies-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fcc53e75e31808acaf195fc37bde7b307ac3ca838243d75d22212fb53a6094bb",
"md5": "4c081c0446c97c1c28319db2a545dfb5",
"sha256": "ec33a17812f66105a010ee2e75efa2fd9ce674c5615ee93f841a58d67042ed40"
},
"downloads": -1,
"filename": "pyfreeproxies-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "4c081c0446c97c1c28319db2a545dfb5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 21152,
"upload_time": "2025-10-22T09:54:46",
"upload_time_iso_8601": "2025-10-22T09:54:46.635632Z",
"url": "https://files.pythonhosted.org/packages/fc/c5/3e75e31808acaf195fc37bde7b307ac3ca838243d75d22212fb53a6094bb/pyfreeproxies-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 09:54:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Simatwa",
"github_project": "pyfreeproxies",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.32.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.6.4"
]
]
}
],
"lcname": "pyfreeproxies"
}
JSON
