API сайта

Преимущества API сайта

данные на страницах сайта кэшируются на несколько часов, соответственно, не являются самыми свежими
самые свежие прокси до первого часа вообще не выводятся на страницы сайта
для API не нужно писать парсеры (любое изменение на сайте потребует корректировки парсера + есть планы добавить защиту от ботов)

Получение доступа к API сайта

Для получения доступа к API необходимо зарегистрироваться на сайте.
Доступ к API возможен для авторизованных пользователей, либо без авторизации - с помощью токена, полученного в личном кабинете пользователя.
Сразу после регистрации новый пользователь получает 3 дня бесплатного доступа к API. Далее доступ к API можно продлить.

Адрес для работы с API

/proxies/api/

Форматы данных

json - формат данных по-умолчанию
csv. Для получения данных в формате csv необходимо добавить ключ в запрос: ?format=csv
txt. Для получения данных в формате csv необходимо добавить ключ в запрос: ?format=txt

Фильтрация данных

Для фильтрации списка прокси-серверов с использованием API используем те же фильтры, что и на http-версии сайта

Примеры

Например, для получения списка socks-прокси 4 типа по России в формате json необходимо использовать фильтр:
proxies.su/proxies/api/?proxy_type=socks4&country=RU

тоже в формате csv:
proxies.su/proxies/api/?proxy_type=socks4&country=RU&format=csv

Python с использованием модуля requests:

import requests
req_session = requests.Session()
req_session.headers['X-API-TOKEN'] = 'your token in base64'
resp = req_session.get('https://proxies.su/proxies/api/?proxy_type=socks4&country=RU')
# check status code of response:
resp.status_code
# get_result:
resp.text

С использованием curl:

curl -H 'X-API-TOKEN: your-token-in-base64' https://proxies.su/proxies/api/?proxy_type=socks4