HProxy/ docs

Free proxy list API

A free, no-auth endpoint that returns our continuously-verified public proxy list as JSON, CSV or plain text. Filter by country, protocol and anonymity. CORS-enabled, so you can call it straight from a browser too.

Live SOCKS5 proxies in the US, as JSON
curl "https://hproxy.com/api/proxy-list?format=json&country=US&protocol=socks5"
Response · array of proxies
[
  {
    "ip": "203.0.113.7",
    "port": 1080,
    "protocols": ["socks4", "socks5"],
    "country_code": "US",
    "city": "New York",
    "anonymity": "elite",
    "latency_ms": 142,
    "uptime_pct": 71.4,
    "status": "alive",
    "last_alive_at": "2026-06-17T00:00:00Z"
  }
]

Query parameters

All optional, combine them freely. Base URL: https://hproxy.com/api/proxy-list.

formattxt | json | csvOutput format. Default txt (ip:port per line).
countryISO codeOnly proxies exiting this country, e.g. US, DE, GB.
protocolhttp | https | socks4 | socks5Only this protocol. Comma-separate for several.
anonymityelite | anonymous | transparentOnly this anonymity grade.
limit1 - 10000Maximum proxies to return. Default 10000.
recenttrueInclude proxies alive within the last 72h, not only live right now.

Good to know

No key, no signup. Free and unauthenticated, but rate limited to roughly 60 requests per minute per IP (a clean 429 with a Retry-After header if you exceed it). Responses are cached ~60s, so you rarely need to poll fast.
Three formats. txt (ip:port lines), json (array), csv. An X-Total-Count header gives the row count.
Also on GitHub. Static hourly snapshots (txt/json/csv, by country) at github.com/hproxy-com/free-proxy-list.
Need proxies that don't die?
Free proxies are shared and unstable. HProxy residential, ISP and mobile proxies stay up, from $0.99/GB. See plans →
Was this helpful?