Документация API для получения прокси-серверов с настройкой фильтров. Удобный инструмент для доступа к списку прокси с выбором типа, анонимности, пинга, страны, города и формата вывода (TXT, JSON). Поддержка авторизации, лимитов использования и скачивания данных. Узнайте, как интегрировать API для работы с прокси.
RU EN
Главная База знаний Документация API Прокси бесплатно Часто задаваемые вопросы Условия использования
Документация API для получения прокси

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

Описание

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

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

Параметр Описание Обязательный Пример значения
key Ключ доступа, необходимый для аутентификации запроса. Да abc123
type Тип прокси-серверов (http, https, socks4, socks5). Можно указать несколько типов через запятую. Нет http,https
anon Уровень анонимности прокси (transparent, anonymous, elite). Нет elite
ping Максимально допустимое время отклика прокси в миллисекундах. Нет 500
time Максимальное время (в секундах) с момента последней проверки прокси. Нет 600
works Количество успешных тестов прокси из общего числа попыток в процентах. Доступные значения: от 0 до 100. Пример использования: works=50 - это значит, что будут выданы прокси, у которых не менее 50% успешных проверок из общего числа тестов на работоспособность. Выводится значение, если выбран формат json. Нет 50
country Код страны прокси (ISO Alpha-2). Можно указать несколько кодов через запятую. Нет us,ca
city Название города прокси. Можно указать несколько городов через запятую. Названия могут быть на русском или английском языке. Нет Париж,Москва
count Количество запрашиваемых прокси. Нет 10
get Формат вывода данных. По умолчанию используется значение txt, что означает вывод в виде текста в браузере. Для вывода в формате JSON используйте get=json. Для скачивания файла используйте get=txt.file или get=json.file. Нет txt, json, txt.file, json.file
timecheck Время последней успешной проверки на работоспособность прокси. Выводится только если выбран формат json. Время указывается в часовом поясе GMT+2. Нет Нельзя указать
ip_out Исходящий результатирующий IP-адрес прокси. Может отличаться от основного IP-адреса прокси. Этот параметр выводится только в формате JSON. Нет Нельзя указать

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

Пример 1: 5 прокси с типом HTTP и анонимностью "elite" в формате JSON

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

Пример 2: 10 прокси с типом HTTPS и максимальным пингом 500 мс в формате TXT-файла для скачивания

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

Пример 3: 2 прокси из США и Канады в формате списка (выводится как текст в браузере)

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

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

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

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

[
    {
        "ip": "15.162.126.1:919",
        "ip_out": "15.162.126.1:919",
        "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:380",
        "type": "http",
        "anon": "elite",
        "ping": 3.83659,
        "timecheck": "2024-11-25 20:09:26",
        "country": "SN",
        "city": "",
        "works": "100"
    }
]

Ошибки

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

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

Лимиты

Примечания

  • Все параметры, кроме key, являются необязательными.
  • Если параметр count не указан, API возвращает максимальное количество доступных прокси.
  • При использовании параметра get=txt.file или get=json.file данные будут предложены для скачивания как файл.
  • Время в поле timecheck, возвращаемое в формате JSON, указывается в часовом поясе GMT+2.

Пример использования в 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 предоставляет удобный инструмент для получения прокси-серверов с широкими возможностями фильтрации. Убедитесь, что у вас есть действующий ключ доступа, и соблюдайте лимиты для бесперебойной работы с сервисом.

0.002 сек