Free Proxy List API
The same JSON API that powers this website. Free for everyone, no API key, no signup. Base URL: https://proxynest.live. All endpoints live on the same origin, e.g. GET /api/stats.
Fair-use limit: 60 requests per minute per IP. Exceeding it returns HTTP 429 with a Retry-After: 60 header. Responses carry Cache-Control: public, max-age=60, so cache them instead of polling.
Totals, per-protocol counts, how many proxies carry real test data, and when the list was last generated.
GET /api/stats
{
"status": "success",
"total": 16936,
"tested": 7859,
"alive": 3652,
"perProtocol": { "http": 3208, "socks4": 678, "socks5": 1744 },
"generatedAt": "2026-10-02T19:17:00Z"
}
Paginated, filterable proxy directory. Only proxies alive at the last check are returned.
| Parameter | Values |
|---|---|
page | Page number, default 1 |
limit | 1–200, default 50 |
protocol | all | http | socks4 | socks5 |
country | Two-letter code, e.g. US, or all |
search | Match against IP or port |
sort | latency | score | port | ip |
order | asc | desc |
GET /api/proxies?protocol=socks5&country=US&limit=2&sort=latency
{
"status": "success",
"page": 1,
"limit": 2,
"total": 481,
"totalPages": 241,
"proxies": [
{
"ip": "107.174.30.92",
"port": 1080,
"protocol": "socks5",
"countryCode": "US",
"country": "United States",
"anonymity": "elite",
"latencyMs": 123,
"uptimePct": 99,
"score": 98,
"tested": 1
},
...
]
}
tested is 1 only when the proxy matched a real speed-test record; otherwise latencyMs, uptimePct and score are null.
Countries present in the list, ordered by proxy count (largest first).
GET /api/countries
{
"status": "success",
"countries": [
{ "code": "US", "name": "United States", "count": 1234 },
{ "code": "DE", "name": "Germany", "count": 486 },
...
]
}
Free MTProto proxies for Telegram, including ready-to-use t.me connect links.
GET /api/mtproto
{
"status": "success",
"count": 333,
"proxies": [
{
"server": "proxy.example.net",
"port": 443,
"secret": "ee1603010200010001fc03...",
"countryCode": "US",
"country": "US",
"latencyMs": 41,
"uptimePct": 87,
"status": "reachable",
"link": "https://t.me/proxy?server=proxy.example.net&port=443&secret=ee1603..."
},
...
]
}
Runs a live connectivity check against one proxy and returns the real measured result. Never a fabricated number. If the proxy is dead, alive is false.
GET /api/verify?target=107.174.30.92:1080
{
"target": "107.174.30.92:1080",
"protocol": "socks5",
"alive": true,
"latencyMs": 595
}
Downloads the full filtered list as a file. Respects the protocol and country filters.
GET /api/export?format=txt&protocol=http&country=DE # plain ip:port list GET /api/export?format=csv&protocol=socks5 # spreadsheet GET /api/export?format=json&country=US # JSON
Code examples
curl
curl "https://proxynest.live/api/proxies?protocol=socks5&country=US&limit=5"
Python (requests)
import requests
r = requests.get("https://proxynest.live/api/proxies",
params={"protocol": "socks5", "country": "US", "limit": 5},
timeout=15)
for p in r.json()["proxies"]:
print(p["ip"], p["port"], p.get("latencyMs"))
Node.js (fetch)
const res = await fetch( "https://proxynest.live/api/proxies?protocol=http&limit=5"); const data = await res.json(); data.proxies.forEach(p => console.log(p.ip, p.port));
PowerShell
$r = Invoke-RestMethod "https://proxynest.live/api/proxies?protocol=http&limit=5"
$r.proxies | ForEach-Object { "$($_.ip):$($_.port)" }
Error codes
| Code | Meaning |
|---|---|
200 | Success. The body has a status field. |
400 | Bad parameter (e.g. invalid country code or limit). |
404 | Unknown endpoint. |
429 | Rate limit exceeded. Wait 60 seconds (see Retry-After). |
500 | Server error. Try again later. |
Changelog
- 2026-10-03: Added /api/status health endpoint; rate limit (60/min) and Cache-Control headers now enforced on all /api/* responses.
- 2026-10-03: /api/comments and /api/captcha added for blog comments.
- 2026-10-03: /api/countries now counts only currently-alive proxies.