GET
/api/proxies
Returns a list of validated proxies sorted by speed (fastest first).
Parameters
| Param |
Type |
Default |
Description |
| protocol |
string |
http |
http | socks4 | all |
| country |
string |
(all) |
ISO 2-letter country code, e.g. US, DE |
Example
curl https://ipproxy.site/api/proxies?protocol=http&country=US
[
{
"ip": "45.77.10.1",
"port": 8080,
"protocol": "HTTP",
"is_valid": true,
"speed_ms": 210,
"country_code": "US",
"last_checked": "2026-03-21T01:30:00"
}
]
GET
/api/stats
Returns current proxy counts and last update timestamp.
curl https://ipproxy.site/api/stats
{
"total": 17462,
"valid": 1498,
"socks5_valid": 854,
"last_updated": "2026-03-21T01:37:13"
}
GET
/api/countries
Returns a list of country codes that have valid proxies available.
curl https://ipproxy.site/api/countries
["AU", "BR", "CA", "DE", "FR", "GB", "JP", "NL", "US", ...]
GET
/api/tools/check-proxy
Test a single proxy in real-time. Rate limited to 10 requests/minute.
Parameters
| Param |
Required |
Description |
| ip |
Yes |
IPv4 address |
| port |
Yes |
Port number (1-65535) |
| protocol |
No |
http (default) | socks4 | socks5 |
curl "https://ipproxy.site/api/tools/check-proxy?ip=45.77.10.1&port=8080&protocol=http"
{"ip": "45.77.10.1", "port": 8080, "protocol": "http", "valid": true, "speed_ms": 340}
Python Example
import requests
# Get fastest HTTP proxies
proxies = requests.get("https://ipproxy.site/api/proxies?protocol=http").json()
for p in proxies[:5]:
print(f"{p['ip']}:{p['port']} — {p['speed_ms']}ms ({p['country_code']})")
# Use the fastest proxy
best = proxies[0]
proxy_url = f"http://{best['ip']}:{best['port']}"
resp = requests.get("https://httpbin.org/ip", proxies={"http": proxy_url}, timeout=10)
print(resp.json())
Rate Limits
| Endpoint |
Limit |
| /api/proxies |
No limit |
| /api/stats |
No limit |
| /api/countries |
No limit |
| /api/tools/check-proxy |
10 req/min per IP |