← Back to the list
Free public API · no key, no signup

Free Proxy List API

One GET request returns the entire live list. The exact data that powers this page — every live HTTP, HTTPS, SOCKS4 and SOCKS5 proxy — straight to your script, refreshed every few minutes.

Get the entire live list in one call

No pagination, no key. Pick a format and you get the whole working pool as a single file or response. recent=true keeps it to the freshest last-48h proxies.

Run it now
curl "https://hproxy.com/api/proxy-list?format=txt&recent=true"
Or download the whole pool

Endpoint

GET https://hproxy.com/api/proxy-list

Open access (CORS enabled). Fair-use rate limit of about 60 requests/min per IP. Over that you get a 429 with a Retry-After header. Every response carries an X-Total-Count header with the number of proxies returned.

Parameters

format
txt · json · csv
Response shape. Default txt (one ip:port per line).
protocol
http · https · socks4 · socks5
Filter by protocol. Comma-separated allowed (e.g. http,https).
country
ISO-3166 alpha-2
Filter by country, e.g. US, DE, RU.
anonymity
elite · anonymous · transparent
Filter by anonymity grade.
limit
1 – 10000
Max rows to return. Default 10000.
recent
true · false
true = only the last-48h working pool (freshest, recommended).

Examples

cURL
curl "https://hproxy.com/api/proxy-list?format=txt&recent=true&protocol=http,https"
Python
import requests

r = requests.get("https://hproxy.com/api/proxy-list", params={
    "format": "json",
    "protocol": "socks5",
    "country": "US",
    "recent": "true",
})
proxies = r.json()
print(len(proxies), "proxies")
Node.js
const res = await fetch(
  "https://hproxy.com/api/proxy-list?format=json&protocol=https&recent=true"
);
const proxies = await res.json();
console.log(proxies.length, "proxies");

Response formats

txt

One ip:port per line. Easiest to pipe straight into tools.

json

Array of objects: ip, port, protocols, country, anonymity, latency and last-checked.

csv

Spreadsheet-ready, with a header row.

Need proxies that don't die?

Free proxies are shared and flaky. For dedicated residential, ISP, IPv4/IPv6 and mobile proxies with real uptime, from $0.99/GB.

See plans
Free Proxy List API — one call, the whole list | HProxy