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:

  1. Descubrir con automático: pasa una regla validate y deja que la progresión determine qué nivel necesita el sitio.
  2. Repetir con single: toma el session.proxy, session.cookies y session.userAgent que devolvió el modo automático y luego llama a Single con ellos para las páginas siguientes en el mismo host.
  3. Recurrir a browser: si single comienza a fallar, cambia al renderizado con browser.
  4. 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.accept en 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 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 reintentos (el valor predeterminado es 5, el máximo es 90).
  • Mantén timeout_ms en 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

Actualizado: 5 de noviembre de 2026