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

Documentacion API para obtener proxies

Descripcion

Esta API proporciona acceso a una lista de servidores proxy con filtros personalizables. El uso requiere una clave de acceso válida, verificada para autenticidad y límites de uso. Según el parámetro get la respuesta se entrega como texto, JSON o archivo descargable. La API está en https://api.good-proxies.ru/api.

Parametros principales de solicitud

Parametro Descripcion Requerido Valor de ejemplo
key Clave de acceso obligatoria para autenticar la solicitud. Si abc123
type Tipo de servidores proxy (http, https, socks4, socks5). Se pueden especificar varios tipos separados por comas. No http,https
anon Nivel de anonimato del proxy (transparente, anonimo, elite). No elite
ping Tiempo maximo de respuesta del proxy en milisegundos. No 500
time Tiempo máximo (en segundos) desde la última verificación del proxy. Predeterminado: 600 (últimos 10 minutos). No 600
works Porcentaje de pruebas de proxy exitosas sobre el total de intentos. Valores disponibles: de 0 a 100. Ejemplo: works=50 significa que se devolveran proxies con al menos 50% de verificaciones exitosas del total de pruebas. El valor se muestra si se selecciona formato json. No 50
country Codigo de pais del proxy (ISO Alpha-2). Se pueden especificar varios codigos separados por comas. No us,ca
cm / country_mode Modo de filtro de países. Valor include (predeterminado): devuelve solo los países especificados. Valor except: excluye de los resultados los países especificados. Se admite el parámetro corto cm (por ejemplo, cm=except) y es compatible con el legado country_mode. No cm=except & country=us,ca
city Nombre de ciudad del proxy. Se pueden especificar varias ciudades separadas por comas. Los nombres pueden estar en ruso o en ingles. No Paris,Moscow
count Numero de proxies solicitados. No 10
lang Idioma para nombres de ciudades en la respuesta y al filtrar por ciudad. ru (predeterminado): nombres en ruso. en: nombres en inglés. Con lang=en, el parámetro city acepta nombres en inglés. No ru, en
get Formato de salida de datos. Por defecto se usa txt, lo que significa salida como texto en el navegador. Para formato JSON use get=json. Para descargar un archivo use get=txt.file o get=json.file. No txt, json, txt.file, json.file
timecheck Hora de la ultima comprobacion exitosa del proxy. Se muestra solo si se selecciona formato json. La hora se indica en zona GMT+2. No No se puede especificar
ip_out Dirección IP de salida resultante del proxy. Puede diferir de la dirección IP principal del proxy. Este parámetro se muestra solo en formato JSON. No No se puede especificar

Parametros de formato TXT

El siguiente parametro controla el formato de linea para get=txt y get=txt.file.

Parametro Descripcion Requerido Valor de ejemplo
type_prefix Agrega el prefijo de protocolo a cada linea de salida TXT: type://ip:port. El valor 1 activa este modo. Ejemplo: http://127.0.0.1:3128. No 1

Parametros de formato JSON

Los siguientes parametros controlan la estructura de respuesta para get=json y get=json.file. No afectan la salida TXT.

Parametro Descripcion Requerido Valor de ejemplo
ip Direccion del servidor proxy en formato ip:port (p. ej. 192.168.1.1:8080). Para separar en campos ip y port, use split_ip=1. No 192.168.1.1:8080
fields Lista de campos separados por comas para incluir en la respuesta JSON. Permitidos: ip, port, ip_out, type, anon, ping, timecheck, country, city, works. Por defecto se devuelven todos los campos. El campo port solo aparece con split_ip=1. No ip,type,country
split_ip Divide el campo ip en formato ip:port en dos campos separados: ip y port. El valor 1 habilita la division. No 1
format Estructura de respuesta JSON. array (predeterminado): matriz de objetos proxy. object: objeto donde las claves son direcciones proxy (ip:port) y los valores son objetos de campos. No array, object
wrap Envuelve la respuesta en un contenedor de metadatos: {status, count, timestamp, filters, data}. El valor 1 habilita este modo. No 1
pretty Formato de respuesta JSON. 1 (predeterminado): formato legible con sangría. 0: JSON compacto sin sangría (menos tráfico). No 0, 1

Ejemplos de solicitud

Ejemplo 1: 5 proxies de tipo HTTP con anonimato "elite" en formato JSON

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

Ejemplo 2: 10 proxies de tipo HTTPS con ping máximo de 500 ms en formato TXT para descargar

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

Ejemplo 3: 2 proxies de EE. UU. y Canadá en formato de lista (mostrado como texto en el navegador)

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

Ejemplo 4: TXT con prefijo de protocolo type://ip:port

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

Salida:

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

Ejemplo 5: JSON: solo campos seleccionados, IP y puerto separados

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

Salida:

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

Ejemplo 6: JSON con envoltorio de metadatos (wrap=1)

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

Salida:

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

Ejemplo 7: Filtrar por ciudad en inglés

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

El parametro lang=en permite especificar ciudades en ingles y recibir nombres de ciudades en ingles en la respuesta.

Ejemplo 8: JSON compacto sin sangría (para procesamiento automático)

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

Formato de respuesta

Respuesta JSON exitosa

Tras una solicitud exitosa con el parametro get=json, la API devuelve una lista de servidores proxy en formato JSON estructurado. Incluye el parametro timecheck, que muestra la hora de la ultima comprobacion exitosa en GMT+2. El parametro ip_out indica la IP de salida del proxy, que puede diferir de la 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"
    }
]

Respuesta TXT exitosa

Si se usa el parámetro get=txt (predeterminado), los datos se devuelven como archivo de texto plano mostrado en el navegador:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Respuesta TXT exitosa para descarga

Si se usa el parámetro get=txt.file, se ofrecerá la descarga de datos en formato de texto:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Respuesta JSON exitosa para descarga

Si se usa el parámetro get=json.file, se ofrecerá la descarga de datos en 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"
    }
]

Errores

Si la solicitud falla, la API devuelve un mensaje de texto que describe el error.

Error: no se proporciono la clave de acceso

Limites

  • Frecuencia de solicitudes: no mas de dos solicitudes cada 5 segundos.
  • Limite diario de solicitudes: hasta 34,560 solicitudes. Cuando se supera el limite, la API devuelve un mensaje de error.
  • Restricción de subred: no mas de 10 subredes IP en formato "a.b.0.0/16". El limite se restablece cada 24 horas. Si se supera el limite, la API devuelve un error.

Notas

  • Todos los parametros, excepto key, son opcionales.
  • Si no se especifica el parámetro count, la API devuelve el número máximo de proxies disponibles.
  • Si no se especifica el parámetro time, se usa el valor predeterminado 600 (proxies verificados en los últimos 10 minutos).
  • Al usar el parametro get=txt.file o get=json.file, los datos se ofreceran para descargar como archivo.
  • La hora en el campo timecheck, devuelta en formato JSON, se especifica en la zona horaria GMT+2.
  • Los parametros JSON (fields, split_ip, format, wrap, pretty) solo afectan respuestas JSON y se ignoran para salida TXT.
  • El parametro type_prefix solo afecta la salida TXT (get=txt y get=txt.file) y se ignora para salida JSON.
  • El parametro lang=en permite especificar nombres de ciudad en ingles en el filtro city y los devuelve en ingles en la respuesta JSON.

Ejemplo de uso en 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 "Error al obtener proxies.";
}

Conclusión

La API ofrece una herramienta conveniente para obtener servidores proxy con amplias capacidades de filtrado. Asegurese de tener una clave de acceso valida y respetar los limites para un funcionamiento ininterrumpido del servicio.

0.001 сек