Crear una tarea

Esta guía te muestra cómo crear una API key y enviar tu primera request usando el Dashboard de FourA.

Paso 1: Abrir el Dashboard

Navega al Dashboard e inicia sesión con tu cuenta de FourA.

Paso 2: Crear una API Key

Ve a la página de API Keys y haz clic en Create Key.

Dale a la key un nombre descriptivo (por ejemplo, "production-scraper" o "dev-testing"). El diálogo de confirmación muestra la key en texto plano con un botón para copiar.

Si la pierdes, haz clic en el icono del ojo en la fila de la key más tarde para revelarla de nuevo. Las keys heredadas creadas antes de que se implementara esta función no se pueden recuperar, vuelve a generarlas una vez para realizar el cambio. Flujo completo: Managing API Keys.

Tu key se ve así: pk_live_a1b2c3d4e5f6...

Paso 3: Elegir un Endpoint

FourA tiene cuatro endpoints para diferentes escenarios:

Auto (`POST /api/auto/`)

La opción predeterminada inteligente. Pasa una URL junto con una regla validate y FourA elige la ruta más barata que funcione: direct request, rotating proxy o navegador completo. Es ideal cuando apuntas a un sitio nuevo y aún no sabes qué necesita.

Single (`POST /api/single/`)

Envía una request HTTP rápida. Es ideal para páginas HTML estáticas y endpoints de API. Tiempo de response: típicamente menos de 2 segundos.

Browser (`POST /api/browser/`)

Ejecuta una instancia del navegador Chrome para renderizar JavaScript. Es ideal para SPAs, contenido con carga diferida y páginas que requieren ejecución de JS. Tiempo de response: de 2 a 10 segundos.

Proxy (`POST /api/proxy/`)

Enruta la request a través de rotating proxies con reintento automático. Es ideal para sitios con detección de bots o contenido con restricciones geográficas.

Paso 4: Enviar tu primera request

Abre una terminal y ejecuta:

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"}'

Paso 5: Leer la response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}

El campo headers es un array de objetos, uno por cada salto de redirección. Cada entrada tiene un result con la línea de estado además de cada header de response que devolvió el destino.

Campos principales:

status: código de estado HTTP del sitio de destino
data: el cuerpo de la response (HTML, JSON o texto sin formato)
total_time: duración de la request en segundos

Paso 6: Probar una request de Browser

Si la página de destino usa JavaScript para renderizar contenido, usa el endpoint de browser en su lugar:

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/products", "timeout_ms": 15000}'

La response del browser usa body en lugar de data:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

Problemas comunes

Problema	Solución
No estás seguro de qué motor usar	Comienza con el endpoint auto. Elige la ruta correcta y recuerda qué funcionó.
Contenido vacío	Cambia del endpoint single al de browser: es probable que la página necesite renderizado de JS.
CAPTCHA en la response	Cambia al endpoint de proxy para la rotación automática de IP.
Timeout	Aumenta `timeout_ms` o verifica que la URL sea correcta.
Perdiste tu key	Haz clic en el icono del ojo en la fila de la key en API Keys para revelarla, o vuelve a generarla si la key es heredada.

Próximos pasos

Dashboard Overview: Recorrido completo por el dashboard
Playground: Prueba requests en el dashboard antes de escribir código
Smart Fetch (Auto): Análisis profundo del endpoint auto
Choosing the Right Endpoint: Comparación detallada
Common Issues: Resuelve problemas rápidamente

Actualizado: 8 de julio de 2026