Docs › Primeros pasos › Inicio rápido

Inicio rápido

Pasa de cero a tu primera recopilación de datos en menos de dos minutos.

Requisitos previos

Paso 1: Obtén tu API key

Inicia sesión en el Dashboard y crea una API key. Se ve así: pk_live_a1b2c3d4e5f6...

Cópiala. La necesitarás para cada request.

Paso 2: Realiza tu primer request

Abre una terminal y ejecuta esto (reemplaza YOUR_API_KEY con tu key real):

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

Esto envía un request HTTP a example.com y devuelve el HTML de la página.

Paso 3: Lee el response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><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 campo result con la línea de estado más cada header del response que el objetivo devolvió para ese salto.

Campos clave:

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

Paso 4: Prueba diferentes endpoints

FourA tiene cuatro endpoints para diferentes situaciones:

Endpoint Velocidad Úsalo cuando
POST /api/auto/ Varía (rápido en hosts precalentados) No sabes qué motor necesita el sitio. Pasa una URL y deja que FourA elija la ruta más barata que funcione.
POST /api/single/ El más rápido (200ms-2s) Páginas estáticas, APIs, sitios renderizados en el servidor
POST /api/browser/ Medio (2s-10s) Páginas con mucho JavaScript, SPAs, contenido dinámico
POST /api/proxy/ Rápido (1s-5s) Sitios con detección de bots, contenido con restricción geográfica

Prueba un request automático (el valor predeterminado inteligente):

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

Prueba un request de navegador:

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

Prueba un request de proxy (rotación automática de proxy):

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 3,
    "request": {
      "method": "GET",
      "url": "https://example.com",
      "unblocker": true
    }
  }'

Siguientes pasos

Actualizado: 1 de julio de 2026
Autenticación →