API de proxies gratis

GET /api/free-proxy devuelve las observaciones públicas actuales de proxies gratis de Litport. No requiere autenticación.

Solicitud#

curl --get 'https://litport.net/api/free-proxy' \
  --data-urlencode 'country=de' \
  --data-urlencode 'protocol=http' \
  --data-urlencode 'uptimeRating=90' \
  --data-urlencode 'sortBy=responseTimeMs_asc' \
  --data-urlencode 'limit=50'

country usa un código ISO-2 sin distinguir mayúsculas de minúsculas y se convierte a mayúsculas para la búsqueda. No tiene tabla de alias: usa country=gb; country=uk puede devolver un array vacío. Los nombres de usuario de los proxies PPG tienen un comportamiento de compatibilidad distinto.

Comportamiento de la respuesta#

La respuesta JSON predeterminada es un array simple, sin envoltorio data, total ni valor hasMore. La paginación es ciega: el desplazamiento de la página es (page - 1) * limit, y un array vacío significa que ninguna fila coincidió en esa página.

El conjunto de datos subyacente puede tener hasta 120 segundos de antigüedad, y las respuestas envían Cache-Control: public, max-age=60 además de eso, por lo que una respuesta puede ir hasta unos 3 minutos por detrás de la última comprobación; consultar a intervalos más cortos que la ventana de caché devuelve las mismas filas. Los parámetros numéricos no válidos y los valores no válidos de sortBy se ignoran en silencio en esta versión y se mantienen sus valores predeterminados. Los valores desconocidos en filtros exactos suelen producir un array vacío en lugar de una respuesta 400.

checkedWithinMin conserva solo los proxies comprobados dentro de la ventana solicitada de 1–1440 minutos. Excluye las marcas de tiempo posteriores a la hora de la solicitud. El endpoint paginado no tiene un filtro de frescura predeterminado, por compatibilidad.

[
  {
    "protocol": "http",
    "host": "192.0.2.10",
    "port": 8080,
    "externalIp": "192.0.2.10",
    "geoCountry": "US",
    "https": true,
    "anonymity": "elite",
    "anonymityRating": 100,
    "responseTimeMs": 420,
    "uptimeRating": 97,
    "pingAt": "2026-08-25T12:00:00.000Z"
  }
]

Las direcciones de ejemplo de esta documentación están reservadas para documentación y no son proxies activos.

Campos JSON#

createdAt registra cuándo observó Litport el proxy por primera vez. pingAt registra la última comprobación y es la señal de frescura relevante. https indica si una solicitud HTTPS a través del proxy se completó con un certificado válido y de confianza; es null hasta que se mide. anonymity indica cuánto expone el proxy sobre sí mismo y sobre quien hace la solicitud (transparent, anonymous, elite o unknown); anonymityLevel es un alias obsoleto de dos valores que se conserva por compatibilidad.

Instantánea consistente#

GET /api/free-proxy/snapshot devuelve una generación completa y filtrada de forma consistente. Usa checkedWithinMin=30 de forma predeterminada, acepta los mismos filtros que el endpoint de lista salvo page, limit, sortBy, format y download, y devuelve hasta 20,000 filas ordenadas por frescura. Un valor no válido de checkedWithinMin devuelve 400.

{
  "generatedAt": "2026-09-09T22:40:12.000Z",
  "count": 2121,
  "totalCount": 2121,
  "truncated": false,
  "maxAgeMin": 30,
  "proxies": []
}

Ambos endpoints incluyen ETag y Last-Modified para solicitudes condicionales. Envía el ETag recibido en If-None-Match; una solicitud válida y coincidente recibe 304 Not Modified solo después de que se haya calculado su respuesta filtrada actual.

Formatos CSV y de texto#

# CSV
curl 'https://litport.net/api/free-proxy?format=csv&limit=25'

# host:port, one proxy per line
curl 'https://litport.net/api/free-proxy?format=txt&limit=25'

# protocol://host:port, one proxy per line
curl 'https://litport.net/api/free-proxy?format=txt-proto&limit=25'

Usa download=1 con un formato admitido para solicitar un archivo adjunto. El CSV se devuelve como text/csv; las variantes de texto usan text/plain; el JSON usa application/json.

Ejemplo en JavaScript#

const url = new URL('https://litport.net/api/free-proxy')
url.searchParams.set('country', 'us')
url.searchParams.set('limit', '25')

const response = await fetch(url)
if (!response.ok) throw new Error(`HTTP ${response.status}`)
const proxies = await response.json()

Ejemplo en Python#

import json
import urllib.parse
import urllib.request

query = urllib.parse.urlencode({"country": "us", "limit": 25})
with urllib.request.urlopen(f"https://litport.net/api/free-proxy?{query}") as response:
    proxies = json.load(response)

Recursos para desarrolladores#

Explora la lista de proxies gratis para revisar los datos actuales, filtrarlos en el navegador y copiar una URL de solicitud para tus propias pruebas.

Usa el código fuente de la lista de proxies gratis para entender el conjunto de datos publicado, o revisa el código fuente del SDK de proxies gratis al integrar la API en una aplicación.

SDK#

Elige un cliente para tu entorno de ejecución. Cada cliente obtiene y filtra registros de proxies; tu aplicación decide cómo usarlos.

Herramientas de la API#

La colección de Postman contiene solicitudes listas para ejecutar para filtros, instantáneas y exportaciones en CSV y texto. No se necesita clave de API.

Usa la imagen de Docker CLI para exportar registros sin instalar un entorno de ejecución de lenguaje local:

docker run --rm litportnet/free-proxy-sdk:0.1.0 --protocol socks5 --limit 20 --format json

El contenedor obtiene registros de proxies; no opera un servidor proxy.

Conecta un agente de IA con el servidor MCP, publicado como @litportnet/free-proxy-mcp e incluido en el MCP Registry oficial como io.github.litportnet/free-proxy-mcp. Agrégalo a cualquier cliente compatible con MCP:

{
  "mcpServers": {
    "free-proxy": {
      "command": "npx",
      "args": ["-y", "@litportnet/free-proxy-mcp"]
    }
  }
}

Expone tres herramientas de solo lectura: listar proxies por filtro, elegir el mejor clasificado y resumir la instantánea actual. Como todos los clientes anteriores, devuelve registros de proxies y no enruta tráfico.

Conjuntos de datos históricos#

Para analizar las distribuciones por protocolo, país y latencia, descarga las observaciones fechadas desde Hugging Face Datasets o Kaggle. Son instantáneas fijas con información sobre su origen y una licencia CC0. Revisa su fecha de observación; para registros actuales usa la API anterior.

El notebook de análisis de Kaggle lee la instantánea y grafica sus distribuciones por país, protocolo y latencia. Puedes ejecutarlo sin llamar a la API en vivo.