Elegir el endpoint correcto
FourA ofrece cuatro endpoints de request, cada uno optimizado para un escenario diferente. Elegir el adecuado ahorra tiempo, reduce costes y mejora las tasas de éxito.
Guía rápida de decisión
Usa el endpoint auto cuando:
- Tu objetivo sea un sitio nuevo y aún no sepas qué necesita
- Quieras una sola llamada que gestione por ti los fallbacks con rotación de proxy y navegador
- Quieras una sesión que puedas reproducir de forma económica en la siguiente llamada al mismo host
Usa el endpoint single cuando:
- La página se renderice en el servidor (no requiere JavaScript)
- Necesites la máxima velocidad (normalmente menos de 1 segundo)
- Consultes API o páginas HTML estáticas de un host que ya sabes que funciona
Usa el endpoint browser cuando:
- La página dependa de JavaScript para renderizar contenido
- El contenido cargue después de la carga inicial de la página
- Necesites el DOM completamente renderizado
Usa el endpoint proxy cuando:
- El sitio de destino bloquee activamente las requests
- Necesites rotar a través de múltiples direcciones IP
- Los intentos anteriores hayan devuelto un error 403 o páginas de verificación
Comparación de endpoints
Auto (POST /api/auto/)
El endpoint smart-fetch. Pasas una URL y (preferiblemente) una regla validate, y FourA recorre una escala que optimiza costes: primero un proxy rotado, luego un navegador completo a través de un proxy. Define forceProxy: false y se ejecutarán previamente un sondeo directo económico y un renderizado directo con navegador. El primer nivel que devuelva una response que coincida con tu validate gana. En llamadas repetidas al mismo host, se reutiliza una sesión activa, por lo que la segunda llamada resulta económica.
curl -X POST https://eu.api.foura.ai/api/auto/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/product/42",
"validate": {"data": {"accept": ["Add to cart"]}}
}'
Tiempo de respuesta típico: 200 ms (activo) a más de 30 s (resolución en frío en un sitio difícil) Ideal para: Nuevos objetivos, sitios con protección mixta, "solo quiero la página"
Para ver un tutorial más detallado, consulta la guía de Smart Fetch.
Single (POST /api/single/)
La opción más rápida. Envía una request HTTP con características de red realistas similares a las de un navegador, sin iniciar un proceso de navegador.
curl -X POST https://eu.api.foura.ai/api/single/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"method": "GET", "url": "https://example.com/api/products"}'
Tiempo de respuesta típico: 200 ms a 2 s Ideal para: API, sitios de noticias, blogs, páginas de productos estáticas
Browser (POST /api/browser/)
Abre tu URL en una instancia del navegador Chrome. La página se carga por completo, JavaScript se ejecuta y obtienes el HTML renderizado final.
curl -X POST https://eu.api.foura.ai/api/browser/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/spa-app",
"timeout_ms": 15000,
"checkText": "data-table"
}'
Tiempo de respuesta típico: 2s a 10s Ideal para: Single-page apps (SPAs), sitios con lazy loading, contenido renderizado con JavaScript
Proxy (POST /api/proxy/)
Combina requests HTTP con rotación automática de proxies. Si el primer intento falla o es bloqueado, FourA reintenta a través de diferentes proxies.
curl -X POST https://eu.api.foura.ai/api/proxy/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"maxTries": 5,
"request": {
"method": "GET",
"url": "https://example.com/pricing"
}
}'
Tiempo de respuesta típico: 1 s a 5 s Ideal para: Monitorización de precios en e-commerce, agregación de viajes, sitios con detección de bots
Automático vs Manual
¿Cuándo deberías dejar que el modo automático elija y cuándo deberías llamar a Single, Proxy o Browser tú mismo?
| Elige automático | Elige manual |
|---|---|
| Aún no sabes qué necesita el sitio | Sabes con precisión qué motor requiere el objetivo |
| Quieres una sola llamada que simplemente funcione | Estás optimizando la estructura del request para un objetivo conocido |
| Aceptas que el modo automático reutilice una sesión que aprendió | Quieres control total sobre reintentos, timeout y elección de proxy por llamada |
| Pagas por unos segundos de sondeo en la primera llamada | La latencia en la primera llamada importa más que el descubrimiento |
El modo automático no siempre es la opción más económica. Si ya sabes que un objetivo funciona con Single y unblocker activado, llamar a Single directamente omite la progresión y cuesta 2 créditos. El modo automático en el mismo objetivo cuesta lo que gaste su progresión.
Cuándo combinar estrategias
Algunos flujos de trabajo se benefician del uso de múltiples endpoints:
- Descubrir con automático: pasa una regla
validatey deja que la progresión determine qué nivel necesita el sitio. - Repetir con single: toma el
session.proxy,session.cookiesysession.userAgentque devolvió el modo automático y luego llama a Single con ellos para las páginas siguientes en el mismo host. - Recurrir a browser: si single comienza a fallar, cambia al renderizado con browser.
- Añadir proxy: si recibes rechazos (403 o una página de verificación) sin el modo automático, envuelve tu request en el endpoint de proxy para una rotación automática.
Este enfoque progresivo mantiene los costos bajos y asegura altas tasas de éxito.
Consejos de rendimiento
- Pasa una subcadena
validate.data.accepten objetivos protegidos. El modo automático reconoce las páginas de desafío comunes por su cuenta, pero solo tu regla puede detectar una página de verificación que no conoce o una página que cargó sin el contenido que necesitas. - Usa el endpoint single por defecto para hosts que sabes que funcionan y solo escala cuando sea necesario.
- Configura
checkTexten requests de browser para que una página renderizada sin tu contenido se reporte como fallo (checkText:<text> not found) en lugar de éxito.checkTextno hace que FourA espere más tiempo por el texto. - Configura
maxTriesen requests de proxy para controlar el comportamiento de reintentos (el valor predeterminado es 5, el máximo es 90). - Mantén
timeout_msen valores razonables: 10 a 15 segundos para la mayoría de las páginas, 30 s o más para ejecuciones automáticas en frío contra sitios protegidos.
Pasos siguientes
- Smart Fetch (Auto): Análisis detallado de
/api/auto/ - API Endpoints: Referencia completa de parámetros
- Scrape a Dynamic Website: Guía paso a paso para requests con browser
- Quick Start: Tu primer request en 30 segundos