Documentação da API de Lista de Proxies

Autenticação

A autenticação é feita pelo e-mail da conta — sem chave separada. Envie o e-mail de uma assinatura ativa em cada requisição.

email deve pertencer a um plano ativo. Ainda não tem uma? Get proxies →

Início rápido

Solicite 50 proxies SOCKS5 elite dos EUA ou da França, em formato 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"])

Parâmetros

Todos os parâmetros são opcionais, exceto e-mail, e podem ser combinados livremente.

Parâmetro	Valores	Descrição
`email`obrigatório	e-mail da conta	Deve pertencer a uma assinatura ativa.
`format`	`text` · `json`	Formato de saída. O padrão é texto.
`country`	`us,fr`	Filtrar por país (separados por vírgula).
`city`	nome da cidade	Filtrar por cidade.
`type`	`http` · `https` · `socks4` · `socks5`	Protocolo (separado por vírgulas).
`port`	número da porta	Filtrar por porta.
`anonymity`	`transparent` · `anonymous` · `elite`	Nível de anonimato.
`state`	região / estado	Filtrar por região.
`timeout`	milissegundos	Apenas proxies com tempo de resposta igual ou inferior a este.
`limit`	`1 – 10000`	Quantos proxies retornar. O padrão é 10000.

Resposta

Com format=json obtém uma matriz de Proxies. Com format=text obtém um ip:porta por linha.

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

Apenas proxies verificados nos últimos 7 dias são retornados, os mais recentes primeiro.

Erros

Um e-mail em falta/inválido ou um plano expirado devolve HTTP 200 com um Aviso e uma lista vazia:

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

Até 10.000 requisições por dia por conta.
Os mesmos dados estão disponíveis em /proxylist/download e /proxylist/v2/api.