free-proxy-list

What the repository provides

This repository is the official, machine readable mirror of the ProxyScrape free proxy list. It republishes the same dataset that is also available through the live api.proxyscrape.com endpoint, but packages it as files in a git repository so any tool can pull it over raw.githubusercontent.com or the jsDelivr CDN. The README states the list covers roughly twenty two thousand proxies across more than ninety countries and includes four protocols: HTTP, HTTPS, SOCKS4 and SOCKS5. The repo refreshes every five minutes from the ProxyScrape v4 API, which the project notes is updated every minute on the live side.

Structure and per proxy metadata

Rather than dumping bare ip:port pairs, the project ships full metadata on every proxy. Each entry carries protocol, ip, port, country, country_code, city, anonymity level, ASN, ISP, uptime percentage, latency and SSL capability. The data is organized into more than two hundred country and protocol shards so a user can pull, for example, US SOCKS5 or German HTTPS directly without any client side filtering. Each protocol also has its own shard plus one combined all shard, and the files are offered in three formats: txt, json and csv. The project deduplicates on the tuple protocol, ip and port and lets empty shards return a 404 instead of serving stale data.

How it relates to the live API

The repo and the API cover the same proxies but on different cadences. The API updates every minute while this mirror updates every five minutes, and the project documents a typed npm SDK for programmatic access alongside the raw file downloads. A Telegram channel, @ps_free_proxy_list, publishes a daily auto refreshing list as well. For most automated workflows the file based shards are enough, but the API is the faster path when sub five minute freshness matters. The README also carries status badges that report total proxy count, country count and last update time so consumers can verify freshness at a glance.

Editorial conclusion

The repository is MIT licensed and maintained by ProxyScrape, with the combined all shard covering every protocol in a single file and per protocol shards split further by country.