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:

• Apuntas a un sitio nuevo y aún no sabes qué necesita
• Quieres una sola llamada que gestione fallbacks directos, con rotación de proxy y de browser por ti
• Quieres 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 renderiza en el servidor (no requiere JavaScript)
• Necesitas la máxima velocidad (normalmente menos de 1 segundo)
• Haces peticiones a APIs o páginas HTML estáticas de un host que ya sabes que funciona

Usa el endpoint browser cuando:

• La página depende de JavaScript para renderizar contenido
• El contenido se carga después de la carga inicial de la página
• Necesitas el DOM completamente renderizado

Usa el endpoint proxy cuando:

• El sitio de destino bloquea activamente las peticiones
• Necesitas rotar entre múltiples direcciones IP
• Los intentos anteriores devolvieron un código 403 o páginas de verificación

Comparación de endpoints

Auto (POST /api/auto/)

El endpoint de smart-fetch. Envías una URL y (preferiblemente) una regla validate, y FourA recorre una escala optimizada por costes: primero un proxy rotado, luego un browser completo a través de un proxy. Define forceProxy: false y se ejecutarán un sondeo directo económico y un renderizado de browser directo antes de ambos. 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 es 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 (en caliente) a más de 30 s (resolución en frío en un sitio complejo) Ideal para: Nuevos objetivos, sitios con protección mixta, "solo quiero la página"

Para un recorrido 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 de 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 peticiones 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 de e-commerce, agregación de viajes, sitios con detección de bots

Auto vs Manual

¿Cuándo deberías dejar que auto elija y cuándo deberías llamar a Single, Proxy o Browser por tu cuenta?

Auto 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 el sondeo y cuesta 2 créditos. Auto en el mismo objetivo cuesta lo que gaste su secuencia progresiva.

Cuándo combinar enfoques

Algunos flujos de trabajo se benefician del uso de múltiples endpoints:

1. Descubre con auto: pasa una regla validate y deja que la secuencia determine qué nivel necesita el sitio.
2. Repite con single: toma los valores session.proxy, session.cookies y session.userAgent que devolvió auto y luego llama a Single con ellos para las páginas siguientes en el mismo host.
3. Recurre a browser: si single comienza a fallar, cambia al renderizado de browser.
4. Añade proxy: si recibes rechazos (403 o una página de verificación) sin auto, envuelve tu request en el endpoint de proxy para rotación automática.

Este enfoque progresivo mantiene los costos bajos y asegura tasas altas de éxito.

Consejos de rendimiento

• Pasa una subcadena validate.data.accept en objetivos protegidos. Auto reconoce por sí mismo las páginas de desafío comunes, pero solo tu regla puede detectar una página de verificación desconocida o una página cargada sin el contenido requerido.
• Usa el endpoint single por defecto para hosts que sabes que funcionan y escala solo cuando sea necesario.
• Configura checkText en requests de browser para que una página renderizada sin tu contenido se reporte como fallo (checkText:<text> not found) en lugar de éxito. checkText no hace que FourA espere más tiempo por el texto.
• Configura maxTries en requests de proxy para controlar el comportamiento de reintento (el valor predeterminado es 5, el máximo es 90).
• Mantén un timeout_ms razonable: 10 a 15 segundos para la mayoría de las páginas, 30 s o más para ejecuciones iniciales en frío de auto contra sitios protegidos.

Próximos pasos

• 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 de browser
• Quick Start: Tu primer request en 30 segundos