Docs › Guías › Elegir el endpoint correcto

Elegir el endpoint correcto

FourA ofrece cuatro request endpoints, cada uno optimizado para un escenario diferente. Elegir el correcto ahorra tiempo, reduce costos y mejora las tasas de éxito.

Guía de decisión rápida

Usa el endpoint auto cuando:

  • Apuntas a un sitio nuevo y aún no sabes qué necesita
  • Quieres una llamada que maneje por ti opciones directas, de proxy rotativo y alternativas de browser
  • 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 máxima velocidad (típicamente menos de 1 segundo)
  • Consultas 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 el contenido
  • El contenido carga después de la carga inicial de la página
  • Necesitas el DOM completamente renderizado

Usa el endpoint proxy cuando:

  • El sitio objetivo bloquea requests de forma activa
  • Necesitas rotar por múltiples direcciones IP
  • Los intentos previos devolvieron 403 o páginas con captcha

Comparación de endpoints

Auto (POST /api/auto/)

El endpoint de recuperación inteligente. Pasas una URL e (idealmente) una regla validate, y FourA recorre una escalera sensible al costo: prueba directa económica, proxy rotativo, browser completo. El primer escalón que devuelve un response que coincida con tu validate gana. En llamadas repetidas al mismo host, se reproduce 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 response típico: 200 ms (activa) a más de 30 s (resolución fría en un sitio difícil) Mejor para: Objetivos nuevos, sitios con protección mixta, "Solo quiero la página"

Para un recorrido más profundo, consulta la guía de Smart Fetch.

Single (POST /api/single/)

La opción más rápida. Envía un HTTP request con características de red realistas similares a las de un browser, sin iniciar un proceso de browser.

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 response típico: 200 ms a 2 s Mejor para: APIs, sitios de noticias, blogs, páginas estáticas de productos

Browser (POST /api/browser/)

Abre tu URL en una instancia del browser Chrome. La página 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 response típico: 2 s a 10 s Mejor para: Single-page apps (SPAs), sitios con carga diferida, contenido renderizado por JavaScript

Proxy (POST /api/proxy/)

Combina HTTP requests con rotación de proxy automática. Si el primer intento falla o es bloqueado, FourA vuelve a intentar 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 response típico: 1 s a 5 s Mejor para: Monitoreo de precios de e-commerce, agregadores de viajes, sitios con detección de bots

Auto frente a Manual

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

Elegir auto Elegir manual
Aún no sabes qué necesita el sitio Sabes exactamente qué motor quiere el objetivo
Quieres una llamada que simplemente funcione Estás optimizando la forma del request para un objetivo conocido
Te parece bien que auto reutilice una sesión que aprendió Quieres control total sobre los reintentos por llamada, timeout y elección de proxy
Pagas por unos segundos de prueba en la primera llamada La latencia en la primera llamada importa más que el descubrimiento

Auto no siempre es la opción más barata. Si ya sabes que un objetivo funciona con Single y unblocker activo, llamar a Single directamente salta la prueba y cuesta 2 créditos. Auto en el mismo objetivo cuesta lo que sea que gaste su escalera.

Cuándo combinar enfoques

Algunos flujos de trabajo se benefician de usar múltiples endpoints:

  1. Descubrir con auto: pasa una regla validate y deja que la escalera descubra qué escalón necesita el sitio.
  2. Reproducir con single: toma los session.proxy, session.cookies y session.userAgent que auto devolvió, luego llama a Single con ellos para las siguientes páginas en el mismo host.
  3. Usar el browser como alternativa: si single comienza a fallar, cambia al renderizado por browser.
  4. Agregar proxy: si estás siendo bloqueado (403 o captcha) sin auto, envuelve tu request en el endpoint proxy para la rotación automática.

Este enfoque progresivo mantiene bajo el costo mientras conserva altas las tasas de éxito.

Consejos de rendimiento

  • Pasa un substring validate.data.accept en objetivos protegidos. Sin él, auto no puede distinguir una página real de un desafío intersticial.
  • Usa el endpoint single por defecto para hosts que sabes que funcionan y solo actualiza cuando sea necesario.
  • Configura checkText en browser requests para evitar esperar por contenido innecesario.
  • Configura maxTries en proxy requests para controlar el comportamiento de reintento (el valor por defecto es 5, el máximo es 90).
  • Mantén timeout_ms en un valor razonable: 10 a 15 segundos para la mayoría de las páginas, más de 30 s para ejecuciones de auto en frío contra sitios protegidos.

Próximos pasos

Actualizado: 30 de junio de 2026
Gestión de protección contra bots →