# Elegir el endpoint correcto

> URL: https://foura.ai/es/docs/guides/choosing-task-type
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

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.

```bash
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](https://foura.ai/docs/guides/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.

```bash
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.

```bash
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.

```bash
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

- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Análisis detallado de `/api/auto/`
- [API Endpoints](https://foura.ai/docs/api/endpoints): Referencia completa de parámetros
- [Scrape a Dynamic Website](https://foura.ai/docs/how-to/scrape-dynamic-website): Guía paso a paso para requests con browser
- [Quick Start](https://foura.ai/docs/getting-started/quick-start): Tu primer request en 30 segundos
