HProxy/ docs

Free proxy list API

GET https://hproxy.com/api/proxy-list returns the whole live free-proxy pool as txt, JSON or CSV. No key, CORS enabled, filterable by country, protocol and anonymity.

GEThttps://hproxy.com/api/proxy-list

The whole live list in one call

One GET returns the entire live pool, every working HTTP, HTTPS, SOCKS4 and SOCKS5 proxy, as txt, json or csv. No key, no signup, no pagination. CORS is enabled, so you can call it straight from a browser. Fair-use rate limit of about 60 requests per minute per IP (a clean 429 with Retry-After beyond that), and every response carries an X-Total-Count header with the number of proxies returned. This is the same data behind the free proxy list.
ParameterTypeDescription
formattxt | json | csvResponse shape. Default txt (one ip:port per line).
protocolhttp | https | socks4 | socks5Filter by protocol. Comma-separated allowed (e.g. http,https).
countryISO-3166 alpha-2Filter by country, e.g. US, DE, GB.
anonymityelite | anonymous | transparentFilter by anonymity grade.
limit1 - 10000Max rows to return. Default 10000.
recenttrue | falsetrue = only the last-48h working pool (freshest, recommended).
curl "https://hproxy.com/api/proxy-list?format=json&country=US&protocol=socks5&recent=true"

The json format returns an array of full objects (geo, ASN, latency, uptime and last-checked timestamps; fields the engine hasn't enriched yet are null, never fabricated). txt is one ip:port per line, easiest to pipe into tools. csv is spreadsheet-ready with a header row.

Need proxies that don't die?
Free proxies are shared and unstable by nature. HProxy residential, ISP and mobile proxies stay up, from $0.65/GB. See plans →

Need a hand wiring this up? Email [email protected]. A real person reads every message.