Документация API для получения прокси-серверов с настройкой фильтров. Удобный инструмент для доступа к списку прокси с выбором типа, анонимности, пинга, страны, города и формата вывода (TXT, JSON). Поддержка авторизации, лимитов использования и скачивания данных. Узнайте, как интегрировать API для работы с прокси.
Inicio
Документация API для получения прокси

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

Parametro Descricao Obrigatorio Valor de exemplo
key Chave de acesso obrigatoria para autenticar a requisicao. Sim abc123
type Tipo de servidores proxy (http, https, socks4, socks5). Varios tipos podem ser especificados separados por virgulas. Não http,https
anon Nivel de anonimato do proxy (transparente, anonimo, elite). Não elite
ping Tempo maximo de resposta do proxy em milissegundos. Não 500
time Tempo máximo (em segundos) desde a última verificação do proxy. Padrão: 600 (últimos 10 minutos). Não 600
works Percentual de testes de proxy bem-sucedidos em relacao ao total de tentativas. Valores disponiveis: de 0 a 100. Exemplo: works=50 significa que serao retornados proxies com pelo menos 50% de verificacoes bem-sucedidas no total de testes. O valor e exibido se o formato json estiver selecionado. Não 50
country Codigo do pais do proxy (ISO Alpha-2). Varios codigos podem ser informados separados por virgulas. Não us,ca
cm / country_mode Modo de filtro por país. Valor include (padrão): retorna apenas os países especificados. Valor except: exclui os países especificados dos resultados. O parâmetro curto cm (ex.: cm=except) é suportado e compatível com o legado country_mode. Não cm=except & country=us,ca
city Nome da cidade do proxy. Varias cidades podem ser informadas separadas por virgulas. Os nomes podem estar em russo ou ingles. Não Paris,Moscow
count Numero de proxies solicitado. Não 10
lang Idioma dos nomes de cidades na resposta e ao filtrar por cidade. ru (padrão) - nomes em russo. en - nomes em inglês. Com lang=en, o parâmetro city aceita nomes de cidades em inglês. Não ru, en
get Formato de saída de dados. Por padrão, usa-se txt, o que significa saída como texto no navegador. Para saída em JSON use get=json. Para baixar um arquivo use get=txt.file ou get=json.file. Não txt, json, txt.file, json.file
timecheck Horario da ultima verificacao bem-sucedida de funcionamento do proxy. Exibido somente se o formato json estiver selecionado. O horario e indicado no fuso GMT+2. Não Nao pode ser especificado
ip_out Endereço IP de saída resultante do proxy. Pode diferir do endereço IP principal do proxy. Este parâmetro é exibido apenas no formato JSON. Não Nao pode ser especificado

Parametros de formato TXT

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

Parametro Descricao Obrigatorio Valor de exemplo
type_prefix Adiciona o prefixo do protocolo a cada linha de saida TXT: type://ip:port. O valor 1 ativa o modo. Exemplo: http://127.0.0.1:3128. Não 1

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.

Parametro Descricao Obrigatorio Valor de exemplo
ip Endereco do servidor proxy no formato ip:port (ex.: 192.168.1.1:8080). Para separar em ip e port, use o parametro split_ip=1. Não 192.168.1.1:8080
fields Lista de campos separados por vírgula para incluir na resposta JSON. Permitidos: ip, port, ip_out, type, anon, ping, timecheck, country, city, works. Por padrão, todos os campos são retornados. O campo port só aparece com split_ip=1. Não ip,type,country
split_ip Divide o campo ip no formato ip:port em dois campos separados: ip e port. O valor 1 ativa a divisao. Não 1
format Estrutura da resposta JSON. array (padrão) - array de objetos proxy. object - objeto em que as chaves são endereços de proxy (ip:port) e os valores são objetos de campos. Não array, object
wrap Encapsula a resposta em um envelope de metadados: {status, count, timestamp, filters, data}. O valor 1 habilita esse modo. Não 1
pretty Formatação da resposta JSON. 1 (padrão) - formato legível com indentação. 0 - JSON compacto sem indentação (menos tráfego). Não 0, 1

Exemplos de requisicao

Exemplo 1: 5 proxies do tipo HTTP com anonimato "elite" em formato JSON

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

Exemplo 2: 10 proxies do tipo HTTPS com ping máximo de 500 ms em formato TXT para download

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

Exemplo 3: 2 proxies dos EUA e Canadá em formato de lista (exibido como texto no navegador)

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

Exemplo 4: TXT com prefixo de protocolo type://ip:port

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

Saída:

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

Exemplo 5: JSON - apenas campos selecionados, IP e porta separados

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

Saída:

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

Exemplo 6: JSON com envelope de metadados (wrap=1)

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

Saída:

{
    "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",
            ...
        }
    ]
}

Exemplo 7: Filtrar por cidade em inglês

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

O parametro lang=en permite especificar cidades em ingles e receber nomes de cidades em ingles na resposta.

Exemplo 8: JSON compacto sem indentação (para processamento automatizado)

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

  • Todos os parametros, exceto key, sao opcionais.
  • Se o parâmetro count não for especificado, a API retorna o número máximo de proxies disponíveis.
  • Se o parâmetro time não for especificado, o valor padrão 600 é usado (proxies verificados nos últimos 10 minutos).
  • Ao usar o parametro get=txt.file ou get=json.file, os dados serao oferecidos para download como arquivo.
  • O horario no campo timecheck, retornado em formato JSON, e especificado no fuso horario GMT+2.
  • Os parametros JSON (fields, split_ip, format, wrap, pretty) afetam apenas respostas JSON e sao ignorados na saida TXT.
  • O parametro type_prefix afeta apenas a saida TXT (get=txt e get=txt.file) e e ignorado na saida JSON.
  • O parametro lang=en permite especificar nomes de cidade em ingles no filtro city e os retorna em ingles na resposta JSON.

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.

2.748 сек