Referencia API

Documentación

Todo lo que necesitas para integrar ProxyHat en tus aplicaciones

Inicio Rápido

Ponte en marcha en minutos

curl -x http://USERNAME:PASSWORD@proxy.proxyhat.com:8080 \
     https://api.example.com/data

Autenticación

Asegura tus peticiones API con tus credenciales

Autenticación con API Key

Todas las peticiones requieren que tu API key se pase en la URL del proxy. Puedes encontrar tu API key en tu panel después de registrarte.

http://USERNAME:PASSWORD@proxy.proxyhat.com:PORT

Endpoints de Proxy

Endpoints de gateway de proxy disponibles

Residencial
HTTP/HTTPS
residential.proxyhat.com
Puertos:8080, 8443

IPs residenciales premium con enrutamiento de calidad filtrado por IA

Datacenter
HTTP/HTTPS
dc.proxyhat.com
Puertos:8080, 8443

Proxies de datacenter de alta velocidad para operaciones masivas

Parámetros de Petición

Personaliza tus peticiones de proxy con estas opciones

ParámetroTipoDescripciónEjemplo
countrystringCódigo de país destino (ISO 3166-1)country=US
citystringNombre de ciudad destinocity=NewYork
sessionstringIdentificador de sesión persistentesession=abc123
ttlnumberTiempo de vida de sesión en segundosttl=600

Ejemplos de Código

Ejemplos de implementación en lenguajes populares

Python
import requests

proxy = "http://user:pass@residential.proxyhat.com:8080"
response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": proxy, "https": proxy}
)
Node.js
const fetch = require('node-fetch');
const HttpsProxyAgent = require('https-proxy-agent');

const agent = new HttpsProxyAgent(
  'http://user:pass@residential.proxyhat.com:8080'
);
fetch('https://httpbin.org/ip', { agent });
Go
proxyURL, _ := url.Parse(
  "http://user:pass@residential.proxyhat.com:8080",
)
client := &http.Client{
  Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
}
resp, _ := client.Get("https://httpbin.org/ip")

Encabezados de Respuesta

Metadatos devueltos con cada petición proxy

X-ProxyHat-IP

La IP del proxy utilizada para esta petición

Ejemplo:203.0.113.45
X-ProxyHat-Country

País de la IP del proxy

Ejemplo:US
X-ProxyHat-Latency

Latencia de la petición en milisegundos

Ejemplo:48

Códigos de Error

Errores comunes y cómo manejarlos

CódigoEstadoDescripciónResolución
407Autenticación RequeridaCredenciales inválidas o faltantesVerifica tu nombre de usuario y contraseña
429Límite de TasaDemasiadas peticionesReduce la frecuencia de peticiones o actualiza tu plan
503No DisponibleNo hay proxies disponibles para los criteriosPrueba con un país diferente o espera

Límites de Tasa

Límites de uso según tu plan

Inicial
100
peticiones/minuto
ancho de banda de 10 GB
Pro
500
peticiones/minuto
ancho de banda de 100 GB
Empresarial
Ilimitado
peticiones/minuto
ancho de banda de Ilimitado

¿Necesitas límites más altos?

Contacta a nuestro equipo para planes empresariales personalizados con peticiones ilimitadas e infraestructura dedicada.

¿Listo para comenzar?

Crea tu cuenta y comienza a usar nuestra infraestructura de proxy en minutos.