API allows you to get an up-to-date list of proxy servers with flexible filters. All requests require authorization with a unique access key. Request caching is supported for high performance.
https://good-proxies.com/api.php
All requests are made using GET method
| Parameter | Description | Example |
|---|---|---|
key * |
Your unique access key (required parameter) | abc123xyz789 |
type |
Proxy type: http, https, socks4, socks5. Multiple types can be specified separated by comma | http,https,socks5 |
anon |
Anonymity level: transparent, anonymous, elite | elite или anonymous |
ping |
Maximum ping in milliseconds (only proxies with lower ping) | 100 (до 0.1 сек) |
time |
Last check time in seconds (default 600 = 10 minutes) | 600 (10 мин) или 3600 (1 час) |
works |
Minimum workability percentage (0-100) | 80 (80% и выше) |
country |
Country codes (ISO 3166-1 alpha-2) comma separated in lowercase | ru,us,de (Россия, США, Германия) |
city |
City names comma separated in lowercase | moscow,new york |
count |
Number of proxies (limited by plan). If not specified - returns maximum by plan | 50 или 100 |
get |
Response format: txt (text), json (JSON), txt.file (download TXT), json.file (download JSON) | json или txt (по умолчанию txt) |
* - required parameter
https://good-proxies.com/api.php?key=your_key&type=http&country=ru&get=json
https://good-proxies.com/api.php?key=your_key&anon=elite&ping=100&count=50&get=json
https://good-proxies.com/api.php?key=your_key&type=https&country=us&count=100&get=txt.file
https://good-proxies.com/api.php?key=your_key&type=socks5&works=90&time=300&get=json
[
{
"ip": "185.162.128.75:8080",
"ip_out": "185.162.128.75",
"type": "https",
"anon": "elite",
"ping": "0.052",
"timecheck": "2025-10-25 14:30:15",
"country": "RU",
"city": "Moscow",
"works": "95"
},
{
"ip": "192.168.1.1:3128",
"ip_out": "192.168.1.1",
"type": "http",
"anon": "anonymous",
"ping": "0.089",
"timecheck": "2025-10-25 14:28:42",
"country": "US",
"city": "New York",
"works": "87"
}
]Field descriptions:
ip - Proxy IP address and portip_out - Outgoing IP addresstype - Proxy type (http, https, socks4, socks5)anon - Anonymity levelping - Ping in secondstimecheck - Last check timecountry - Country codecity - Cityworks - Uptime percentage"Ошибка: Ключ доступа не предоставлен""Ошибка: Неверный ключ доступа или срок действия ключа истек""Ошибка: Лимит на запросы к API на сегодня завершен.""Разрешено не более N подсетей для ключа в сутки. Ваш лимит превышен.""Ошибка: Не найдено подходящих прокси"All errors are returned as plain text
Limitations depend on your plan. Check them in your dashboard.