Docs › Guías › Elegir el endpoint correcto

Elegir el endpoint correcto

FourA ofrece tres endpoints de API, cada uno optimizado para diferentes escenarios. Elegir el correcto ahorra tiempo, reduce costos y mejora las tasas de éxito.

Guía de decisión rápida

Use el endpoint single cuando:

  • La página de destino se renderiza en el servidor (no requiere JavaScript)
  • Necesita la máxima velocidad (normalmente menos de 1 segundo)
  • Está recopilando datos de APIs o páginas HTML estáticas

Use el endpoint browser cuando:

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

Use el endpoint proxy cuando:

  • El sitio de destino bloquea activamente las requests
  • Necesita rotar a través de múltiples direcciones IP
  • Los intentos anteriores devolvieron páginas 403 o captcha

Comparación de endpoints

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", "unblocker": true}'

Tiempo de response típico: 200 ms a 2 s Ideal para: APIs, sitios de noticias, blogs, páginas de productos estáticas

Browser (POST /api/browser/)

Abre su URL en una instancia del navegador Chrome. La página se carga por completo, se ejecuta JavaScript y usted obtiene 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 Ideal para: Aplicaciones de una sola página (SPAs), sitios con carga diferida (lazy loading), contenido renderizado por JavaScript

Proxy (POST /api/proxy/)

Combina requests HTTP con rotación automática de proxy. 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",
      "unblocker": true
    }
  }'

Tiempo de response típico: 1 s a 5 s Ideal para: Monitoreo de precios de comercio electrónico, agregadores de viajes, sitios con detección de bots

Cuándo combinar enfoques

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

  1. Comience con single: pruebe si la página devuelve datos útiles sin un navegador.
  2. Recurra a browser: si la response está vacía o falta contenido, cambie al renderizado de browser.
  3. Agregue proxy: si lo están bloqueando (403/captcha), envuelva su request en el endpoint proxy para una rotación automática de IP.

Este enfoque progresivo mantiene los costos bajos mientras maximiza las tasas de éxito.

Consejos de rendimiento

  • Use el endpoint single por defecto y solo actualice cuando sea necesario
  • Establezca checkText en las requests de browser para evitar esperar por contenido innecesario
  • Establezca maxTries en las requests de proxy para controlar el comportamiento de reintento (el valor por defecto es 5, el máximo es 90)
  • Mantenga los valores de timeout_ms razonables: de 10 a 15 segundos para la mayoría de las páginas

Próximos pasos

Actualizado: 30 de junio de 2026
Gestión de protección anti-bot →