Documentación
Documentación de API e integración de proxies
Conecta cualquier cliente HTTP o SOCKS5 con un host y un login por red, elige ubicaciones y sesiones con claves en el nombre de usuario, y gestiona planes con la API REST.
Hosts y puertos
Cada red tiene un host. HTTP y HTTPS comparten el primer puerto, SOCKS5 usa el segundo. El nombre de usuario y contraseña vienen del plan en tu panel y son los mismos para ambos protocolos.
| Red | Host | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Proxies residenciales | res.proxyhive.cc | 7000 | 7001 |
| Proxies móviles | mob.proxyhive.cc | 7100 | 7101 |
| Proxies ISP estáticos | isp.proxyhive.cc | 8000 | 8001 |
| Proxies de datacenter | dc.proxyhive.cc | 7200 | 7201 |
Los planes ISP estáticos listan cada dirección con su propio puerto en lugar de un host compartido: conéctate a ip:puerto con el nombre de usuario y contraseña del plan.
Claves de nombre de usuario
Las claves se añaden a tu nombre de usuario con guiones y pueden combinarse en cualquier orden. Sin claves, un plan rotativo devuelve una dirección aleatoria en cualquier país.
| Clave | Qué hace | Redes |
|---|---|---|
| country-us | Código de país ISO de dos letras. | Residencial, móvil, datacenter |
| state-texas | Un estado de EE.UU. o región de primer nivel. | Residencial |
| city-new_york | Una ciudad, en minúsculas, espacios como guiones bajos. | Residencial, móvil |
| carrier-tmobile | Un operador móvil en minúsculas, sin espacios. | Móvil |
| session-a1b2c3 | Mantiene una IP para la sesión, de 6 a 10 letras o dígitos. | Residencial, móvil, datacenter |
| ttl-30 | Minutos que una sesión mantiene su IP, de 1 a 1,440. Por defecto 10. | Residencial, móvil, datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Ejemplos de código
Reemplaza USER y PASS con el login de tu plan. Los ejemplos envían una solicitud a través de la pasarela y muestran la respuesta.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
API REST
Dirección base https://proxyhive.cc/api/v1. Las respuestas son JSON y siempre incluyen ok. Los endpoints públicos no necesitan clave; los de cuenta necesitan el encabezado Authorization: Bearer con la clave API de tu página de cuenta.
| Método | Ruta | Qué hace | Clave |
|---|---|---|---|
| GET | /plans | Cada plan con id, producto, tamaño, tarifa y precio. | No |
| GET | /locations | Países con tamaños de pool, ciudades y operadores. | No |
| GET | /balance | Tu saldo en USD. | Sí |
| POST | /orders | Compra un plan: id de plan y país (o cualquiera). | Sí |
| GET | /orders | Tus planes con logins, tráfico restante y expiración. | Sí |
| GET | /orders/{id} | Un plan por su código. | Sí |
curl -X POST https://proxyhive.cc/api/v1/orders \
-H "Authorization: Bearer phk_..." \
-H "Content-Type: application/json" \
-d '{"plan": "res-100", "country": "any"}'{
"ok": true,
"order": {
"id": "HO-7K2M9QXR4T",
"product": "resi",
"plan": "res-100",
"quantity": 100,
"unit": "GB",
"status": "active",
"gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
}
}Errores y límites
Las llamadas fallidas responden ok: false con un código de error y un mensaje: unauthorized (401), bad_plan o bad_country (400), funds (402, con la cantidad aún necesaria), network (503, no se cobró nada) y rate_limited (429). Cada clave API puede enviar 300 solicitudes por minuto.
Comienza con ProxyHive
Crea una cuenta en segundos, añade saldo con cripto y copia tu primer inicio de sesión proxy. Cada plan comienza en $30.