{"id":15718425,"url":"https://github.com/justintime50/proxlist","last_synced_at":"2025-07-15T07:15:52.360Z","repository":{"id":45557971,"uuid":"435710475","full_name":"Justintime50/proxlist","owner":"Justintime50","description":"Retrieve free, open-source proxy servers.","archived":false,"fork":false,"pushed_at":"2024-10-10T21:59:31.000Z","size":44,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T22:44:44.844Z","etag":null,"topics":["free","http-proxy","list","open-source","proxies","proxlist","proxy","proxy-server","proxylist","server"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Justintime50.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-07T01:58:44.000Z","updated_at":"2025-03-18T11:53:54.000Z","dependencies_parsed_at":"2022-09-10T00:40:38.449Z","dependency_job_id":"dc95fe37-6a24-48f8-8dc3-b06769421833","html_url":"https://github.com/Justintime50/proxlist","commit_stats":{"total_commits":19,"total_committers":1,"mean_commits":19.0,"dds":0.0,"last_synced_commit":"d172fc4d0cdd5a30f4ea30fe5ba8bb4a51dcc6c6"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":"Justintime50/python-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fproxlist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fproxlist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fproxlist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justintime50%2Fproxlist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Justintime50","download_url":"https://codeload.github.com/Justintime50/proxlist/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252967974,"owners_count":21833245,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["free","http-proxy","list","open-source","proxies","proxlist","proxy","proxy-server","proxylist","server"],"created_at":"2024-10-03T21:53:02.838Z","updated_at":"2025-05-07T22:44:50.153Z","avatar_url":"https://github.com/Justintime50.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Proxlist\n\nRetrieve free, open-source proxy servers.\n\n[![Build Status](https://github.com/Justintime50/proxlist/workflows/build/badge.svg)](https://github.com/Justintime50/proxlist/actions)\n[![Coverage Status](https://coveralls.io/repos/github/Justintime50/proxlist/badge.svg?branch=main)](https://coveralls.io/github/Justintime50/proxlist?branch=main)\n[![PyPi](https://img.shields.io/pypi/v/proxlist)](https://pypi.org/project/proxlist)\n[![Licence](https://img.shields.io/github/license/Justintime50/proxlist)](LICENSE)\n\n\u003cimg src=\"https://raw.githubusercontent.com/justintime50/assets/main/src/proxlist/showcase.png\" alt=\"Showcase\"\u003e\n\n\u003c/div\u003e\n\nFinding and storing a list of proxies can be taxing - especially ones that are free and actually work. `proxlist` will validate and return a rotating random proxy so you don't need to keep a list of proxies or ensure the list is still valid.\n\nProxies are returned in the form of strings (eg: `ip:port`).\n\nThese proxies come from all over the world and may not be performant for a production application. Instead, you should use a paid proxy service or a self-hosted solution. This package is intended for testing purposes and there are no guarantees about where the data sent through these proxies goes or how it's handled. The list and quality of proxies rotates rapidly - your mileage may vary.\n\n## Install\n\n```bash\n# Install tool\npip3 install proxlist\n\n# Install locally\njust install\n```\n\n## Usage\n\n```python\nimport proxlist\nimport requests\n\n# Get a random proxy\nproxy = proxlist.random_proxy()\n\n# You can also filter proxies by country or google_verified\nproxies = proxlist.random_proxy(country='US', google_verified=True)\n\n# Alternatively, you could get the entire list of current proxies (and could optionally filter them like above)\nproxies = proxlist.list_proxies()\n\n# Depending on the proxy and your location in the world, you may need to adjust the timeout\n# to provide the proxy enough time to route your request. Additionally, some of these proxies\n# may be unstable - adding retry logic is highly recommended. Caching a working proxy is also\n# a good idea with a fallback of retrying if the cached proxy no longer works or times out.\nresponse = requests.get(\n    'https://google.com',\n    proxies={\n        'http': f'http://{proxy}',\n        'https': f'http://{proxy}',\n    },\n    timeout=10,\n)\n\nprint(response.text)\n```\n\n## Development\n\n```bash\n# Get a comprehensive list of development tools\njust --list\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustintime50%2Fproxlist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustintime50%2Fproxlist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustintime50%2Fproxlist/lists"}