API позволяет получать актуальный список прокси-серверов с гибкими фильтрами. Все запросы требуют авторизации по уникальному ключу доступа. Поддерживается кэширование запросов для высокой производительности.
https://good-proxies.com/api.php
Все запросы выполняются методом GET
| Параметр | Описание | Пример |
|---|---|---|
key * |
Ваш уникальный ключ доступа (обязательный параметр) | abc123xyz789 |
type |
Тип прокси: http, https, socks4, socks5. Можно указать несколько через запятую | http,https,socks5 |
anon |
Уровень анонимности: transparent (прозрачный), anonymous (анонимный), elite (элитный) | elite или anonymous |
ping |
Максимальный пинг в миллисекундах (только прокси с меньшим пингом) | 100 (до 0.1 сек) |
time |
Время последней проверки в секундах (по умолчанию 600 = 10 минут) | 600 (10 мин) или 3600 (1 час) |
works |
Минимальная работоспособность в процентах (0-100) | 80 (80% и выше) |
country |
Коды стран (ISO 3166-1 alpha-2) через запятую в нижнем регистре | ru,us,de (Россия, США, Германия) |
city |
Названия городов через запятую в нижнем регистре | moscow,new york |
count |
Количество прокси (ограничено тарифом). Если не указано - возвращается максимум по тарифу | 50 или 100 |
get |
Формат ответа: txt (текст), json (JSON), txt.file (скачать TXT), json.file (скачать JSON) | json или txt (по умолчанию txt) |
* - обязательный параметр
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"
}
]Описание полей:
ip - IP адрес и порт проксиip_out - Исходящий IP адресtype - Тип прокси (http, https, socks4, socks5)anon - Уровень анонимностиping - Пинг в секундахtimecheck - Время последней проверкиcountry - Код страныcity - Городworks - Работоспособность в процентах"Ошибка: Ключ доступа не предоставлен""Ошибка: Неверный ключ доступа или срок действия ключа истек""Ошибка: Лимит на запросы к API на сегодня завершен.""Разрешено не более N подсетей для ключа в сутки. Ваш лимит превышен.""Ошибка: Не найдено подходящих прокси"Все ошибки возвращаются в виде простого текста
Ограничения зависят от вашего тарифа. Проверьте их в личном кабинете.