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

Аутентификация

Аутентификация выполняется по email аккаунта — отдельный ключ не нужен. Передавайте email с активной подпиской в каждом запросе.

email должен относиться к активному тарифу. Ещё нет аккаунта? Get proxies →

Быстрый старт

Запросить 50 элитных SOCKS5 прокси из США или Франции в формате JSON.

curl "https://www.proxydocker.com/proxylist/api?email=you@example.com&format=json\
&country=us,fr&type=socks5&anonymity=elite&limit=50"

import requests

resp = requests.get(
    "https://www.proxydocker.com/proxylist/api",
    params={
        "email": "you@example.com",
        "format": "json",
        "country": "us,fr",
        "type": "socks5",
        "anonymity": "elite",
        "limit": 50,
    },
    timeout=30,
)
proxies = resp.json()["Proxies"]

for p in proxies:
    print(f"{p['ip']}:{p['port']}", p["type"], p["country"])

Параметры

Все параметры необязательны, кроме email, и могут свободно комбинироваться.

Параметр	Значения	Описание
`email`обязательно	email аккаунта	Должен относиться к активной подписке.
`format`	`text` · `json`	Формат вывода. По умолчанию text.
`country`	`us,fr`	Фильтр по странам (через запятую).
`city`	название города	Фильтр по городу.
`type`	`http` · `https` · `socks4` · `socks5`	Протокол (через запятую).
`port`	номер порта	Фильтр по порту.
`anonymity`	`transparent` · `anonymous` · `elite`	Уровень анонимности.
`state`	регион / штат	Фильтр по региону.
`timeout`	миллисекунд	Только прокси с этим временем отклика или ниже.
`limit`	`1 – 10000`	Количество возвращаемых прокси. По умолчанию: 10000.

Ответ

С format=json вы получаете массив прокси (Proxies). С помощью format=text вы получаете по одному ip:port на строку.

{
  "Proxies": [
    {
      "ip": "188.34.22.10",
      "port": 1080,
      "type": "SOCKS5",
      "country": "United States",
      "code": "US",
      "city": "Ashburn",
      "anonymity": "elite",
      "timeout": 420
    }
  ]
}

Возвращаются только прокси, проверенные за последние 7 дней, сначала новые.

Ошибки

Отсутствующий/недействительный email или истекший тариф возвращают код HTTP 200 со значащим Notice и пустым списком:

{ "Notice": "Your package is already expired.", "Proxies": [] }

До 10 000 запросов в день на один аккаунт.
Те же данные доступны на /proxylist/download и /proxylist/v2/api.