Documentacao da API para obter proxies

Descricao

Esta API fornece acesso a uma lista de servidores proxy com filtros personalizaveis. O uso requer uma chave de acesso valida, verificada quanto a autenticidade e limites. Conforme o parametro get, os dados sao retornados em texto, JSON ou arquivo para download. A API esta em https://api.good-proxies.ru/api.

Parametros principais da requisicao

Parametros de formato TXT

O parametro a seguir controla o formato de linha para get=txt e get=txt.file.

Parametros de formato JSON

Os parametros a seguir controlam a estrutura da resposta para get=json e get=json.file. Eles nao afetam a saida TXT.

Exemplos de requisicao

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

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

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

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=5&type_prefix=1

http://192.168.1.1:8080
http://192.168.1.2:3128
http://192.168.1.3:8118

GET https://api.good-proxies.ru/api?key=abc123&type=socks5&count=2&get=json&fields=ip,port,type,country&split_ip=1

[
    {
        "ip": "192.168.1.1",
        "port": "1080",
        "type": "socks5",
        "country": "US"
    },
    {
        "ip": "192.168.1.2",
        "port": "1080",
        "type": "socks5",
        "country": "DE"
    }
]

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=2&get=json&wrap=1

{
    "status": "ok",
    "count": 2,
    "timestamp": "2026-03-01T12:00:00+00:00",
    "filters": {
        "type": "http",
        "time": 600
    },
    "data": [
        {
            "ip": "192.168.1.1:8080",
            "type": "http",
            ...
        }
    ]
}

GET https://api.good-proxies.ru/api?key=abc123&city=Paris,London&count=5&get=json&lang=en

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=10&get=json&pretty=0

Formato de resposta

Resposta JSON bem-sucedida

Apos uma solicitacao bem-sucedida com o parametro get=json, a API retorna uma lista de servidores proxy em formato JSON estruturado. Inclui o parametro timecheck, que mostra o horario da ultima verificacao bem-sucedida em GMT+2. O parametro ip_out indica o IP de saida do proxy, que pode diferir do principal.

[
    {
        "ip": "15.162.126.1:919",
        "ip_out": "15.162.126.1",
        "type": "http",
        "anon": "transparent",
        "ping": 5.07786,
        "timecheck": "2024-11-25 20:09:25",
        "country": "CO",
        "city": "Медельин",
        "works": "66"
    }
]

Resposta TXT bem-sucedida

Se o parГўmetro get=txt (padrГЈo) for usado, os dados sГЈo retornados como um arquivo de texto simples exibido no navegador:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Resposta TXT bem-sucedida para download

Se o parГўmetro get=txt.file for usado, os dados serГЈo oferecidos para download no formato de texto:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Resposta JSON bem-sucedida para download

Se o parГўmetro get=json.file for usado, os dados serГЈo oferecidos para download no formato JSON:

[
    {
        "ip": "112.63.11.8:180",
        "ip_out": "122.63.41.1",
        "type": "http",
        "anon": "elite",
        "ping": 3.83659,
        "timecheck": "2024-11-25 20:09:26",
        "country": "SN",
        "city": "",
        "works": "100"
    }
]

Erros

Se a solicitação falhar, a API retorna uma mensagem de texto descrevendo o erro.

Erro: chave de acesso nao fornecida

Limites

• Frequencia de requisicoes: nao mais que duas requisicoes a cada 5 segundos.
• Limite diario de requisicoes: ate 34.560 requisicoes. Quando o limite e excedido, a API retorna uma mensagem de erro.
• Restrição de sub-rede: nao mais que 10 sub-redes IP no formato "a.b.0.0/16". O limite e redefinido a cada 24 horas. Se o limite for excedido, a API retorna um erro.

Notas

Exemplo de uso em 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 "Erro ao obter proxies.";
}

Conclusao

A API fornece uma ferramenta conveniente para obter servidores proxy com amplas capacidades de filtragem. Certifique-se de ter uma chave de acesso valida e respeitar os limites para operacao ininterrupta do servico.