Документация API для получения прокси

Описание

API даёт доступ к списку прокси с гибкими фильтрами. Нужен действующий ключ — он проверяется на подлинность и лимиты. Ответ зависит от параметра get: текст, JSON или файл для скачивания. Адрес API: https://api.good-proxies.ru/api.

Основные параметры запроса

Параметры TXT-формата

Следующий параметр управляет форматом строки при get=txt и get=txt.file.

Параметры JSON-формата

Следующие параметры управляют структурой ответа при get=json и get=json.file. На TXT-вывод не влияют.

Примеры запросов

GET https://api.good-proxies.ru/api?key=abc123&type=http&anon=elite&count=5&get=json

GET https://api.good-proxies.ru/api?key=abc123&type=https&ping=500&count=10&get=txt.file

GET https://api.good-proxies.ru/api?key=abc123&country=us,ca&count=2

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=5&type_prefix=1

http://192.168.1.1:8080
http://192.168.1.2:3128
http://192.168.1.3:8118

GET https://api.good-proxies.ru/api?key=abc123&type=socks5&count=2&get=json&fields=ip,port,type,country&split_ip=1

[
    {
        "ip": "192.168.1.1",
        "port": "1080",
        "type": "socks5",
        "country": "US"
    },
    {
        "ip": "192.168.1.2",
        "port": "1080",
        "type": "socks5",
        "country": "DE"
    }
]

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=2&get=json&wrap=1

{
    "status": "ok",
    "count": 2,
    "timestamp": "2026-03-01T12:00:00+00:00",
    "filters": {
        "type": "http",
        "time": 600
    },
    "data": [
        {
            "ip": "192.168.1.1:8080",
            "type": "http",
            ...
        }
    ]
}

GET https://api.good-proxies.ru/api?key=abc123&city=Paris,London&count=5&get=json&lang=en

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=10&get=json&pretty=0

Формат ответа

Успешный ответ в формате JSON

При успешном запросе с параметром get=json, API возвращает список прокси-серверов в структурированном формате JSON. Включает параметр timecheck, который показывает время последней успешной проверки в часовом поясе GMT+2. Параметр ip_out указывает результатирующий IP-адрес прокси, который может отличаться от основного.

[
    {
        "ip": "15.162.126.1:919",
        "ip_out": "15.162.126.1",
        "type": "http",
        "anon": "transparent",
        "ping": 5.07786,
        "timecheck": "2024-11-25 20:09:25",
        "country": "CO",
        "city": "Медельин",
        "works": "66"
    }
]

Успешный ответ в формате TXT

Если get=txt (по умолчанию), ответ — простой текст в браузере:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Успешный ответ в формате TXT для скачивания

Если get=txt.file, ответ скачивается как текстовый файл:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Успешный ответ в формате JSON для скачивания

Если get=json.file, ответ скачивается как JSON-файл:

[
    {
        "ip": "112.63.11.8:180",
        "ip_out": "122.63.41.1",
        "type": "http",
        "anon": "elite",
        "ping": 3.83659,
        "timecheck": "2024-11-25 20:09:26",
        "country": "SN",
        "city": "",
        "works": "100"
    }
]

Ошибки

Если запрос не удался, API возвращает текстовое сообщение с описанием ошибки.

Ошибка: Ключ доступа не предоставлен

Лимиты

• Частота запросов: не более двух запросов каждые 5 секунд.
• Лимит запросов в день: до 34,560 запросов. При превышении лимита API возвращает сообщение об ошибке.
• Ограничение по подсетям: не более 10 подсетей IP формата "a.b.0.0/16". Лимит сбрасывается каждые 24 часа. Если лимит превышен, API возвращает ошибку.

Примечания

Пример использования в PHP

$key = 'abc123';
$type = 'http';
$anon = 'elite';
$count = 5;
$get = 'json';

$url = "https://api.good-proxies.ru/api?key=$key&type=$type&anon=$anon&count=$count&get=$get";

$response = file_get_contents($url);

if ($response) {
    $proxies = json_decode($response, true);
    print_r($proxies);
} else {
    echo "Ошибка при получении прокси.";
}

Заключение

API даёт удобный способ получать прокси с гибкими фильтрами. Проверьте, что ключ действует, и соблюдайте лимиты — тогда работа пойдёт без сбоев.