Для повышения удобства работы и хранения данных веб-сайт использует файлы COOKIE. Продолжая работу с веб-сайтом, Вы даете свое согласие на работу с этими файлами.

 


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