Obtener proxy

Obtener proxy

Obtén un endpoint de proxy optimizado para tu destino.

Endpoint

GET /v1/proxy

Parámetros

Parámetro	Tipo	Requerido	Descripción
target	string	Sí	Dominio de destino (p. ej. amazon.com)
session_lock	boolean	No	Mantener la misma IP durante la sesión (por defecto: false)
country	string	No	Código de país ISO 3166-1 alpha-2
ip_type	string	No	residential, datacenter o dedicated
session_ttl	integer	No	Tiempo de expiración de la sesión en segundos (por defecto: 1800)
auto_heal	boolean	No	Habilitar la conmutación automática (por defecto: true)

Petición

curl "https://api.hydraskill.ai/v1/proxy?target=amazon.com&session_lock=true&country=US" \
  -H "Authorization: Bearer sk-your-key"

Respuesta

{
  "proxy_id": "px_abc123",
  "host": "us-res-42.proxy.hydraskill.ai",
  "port": 8080,
  "username": "session_abc123",
  "password": "px_token_xyz",
  "ip": "203.0.113.42",
  "country": "US",
  "type": "residential",
  "session_lock": true,
  "expires_at": "2026-05-30T16:30:00Z",
  "protocol": "http"
}

Uso con un cliente HTTP

proxy = client.get_proxy(target="amazon.com", session_lock=True)

# Convertir a un dict compatible con requests
proxies = proxy.to_dict()
# {'http': 'http://user:pass@host:port', 'https': 'http://user:pass@host:port'}

response = requests.get(url, proxies=proxies)

Códigos de error

Código	Significado
400	Falta el parámetro requerido target
401	API key inválida
402	Saldo insuficiente / límite del plan alcanzado
429	Límite de tasa superado
503	No hay proxies disponibles para los criterios solicitados