Documentación proxy CrawlRelay: inicio rápido

¿Cómo envío mi primera solicitud?

Copia el nombre de usuario y la contraseña de tu panel, luego ejecuta uno de estos comandos. Cada uno muestra la dirección IP que ve el sitio web, la cual suele cambiar en cada ejecución.

curl -x http://USERNAME-country-us:[email protected]:7777 https://api.ipify.org

import requests

proxy = "http://USERNAME-country-us:[email protected]:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)

import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:[email protected]:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());

¿Cómo construyo el nombre de usuario?

Empieza con el nombre de usuario en tu panel y añade parámetros con guiones, en el orden del formato arriba. Cada parámetro es opcional. Los valores van en minúsculas y los nombres de ciudad usan guiones bajos (new_york, sao_paulo). La disponibilidad de ciudades varía.

¿Cómo se comportan las sesiones rotativas y persistentes?

Un nombre de usuario sin session- recibe una IP del pool en cada nueva conexión TCP, usualmente diferente. Un nombre de usuario con session-<id>-ttl-<minutes> mantiene la misma IP de salida para ese ID hasta que expire el TTL o el dispositivo residencial se desconecte.

• La rotación ocurre por conexión, no por solicitud: keep-alive reutiliza la misma IP de salida.
• Usa un ID de sesión nuevo por trabajo, contexto de navegador o flujo de cuenta.
• Dos scrapers que envían el mismo ID de sesión comparten una IP de salida.

La guía de sesiones cubre el reuso de conexiones en cada librería.

¿Cuáles son los límites?

• Destinos bloqueados: Sitios bancarios, gubernamentales y portales de pago, además de puertos SMTP (envío de emails) 25, 465 y 587. Las solicitudes a estos se rechazan.
• Uso: solo datos públicos, según la Política de Uso Aceptable. No se permite la toma de control de cuentas, fraude, spam ni intentos de evadir bloqueos deliberados de un sitio.
• Tráfico: se factura por GB. El uso contabiliza todos los datos enviados y recibidos a través del proxy (subida y bajada, incluyendo cabeceras). 1 GB = 1.000.000.000 bytes. Los intentos de conexión que fallan antes de llegar al destino no se cuentan.. Las solicitudes se detienen cuando se agota el tráfico del plan.
• Sesiones: hasta 30 minutos; la IP puede cambiar antes, por ejemplo, si el dispositivo residencial se desconecta.
• Protocolos: HTTP, HTTPS (CONNECT) y SOCKS5.
• Concurrencia: no se factura. Tu límite es lo que acepta cada destino; consulta la guía de concurrencia.

¿Cómo manejo las credenciales y el uso?

En el panel o vía REST API en https://crawlrelay.com/api/v1 con una clave API. Claves API que puedes revocar en cualquier momento. Las tareas principales:

• Subusuarios: un conjunto de credenciales por scraper o proyecto cliente, con límite opcional de tráfico. Consulta la API residencial.
• Lista blanca de IP: hasta 10 IPs que pueden conectarse sin contraseña.
• Uso: tráfico diario por suscripción, para alertar antes de que se agote el crawl.
• Catálogo: países, ciudades, estados y ASN que puedes dirigir, para que tu código valide un usuario antes de usarlo.
• Pedidos: compra más tráfico desde tu saldo sin abrir el panel. Consulta la API de pedidos.