Docs › Primeros pasos › Inicio rápido

Inicio rápido

Pasa de cero a tu primera recolecció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: Haz 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 una request HTTP a example.com y devuelve el HTML de la página.

Paso 3: Lee la 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 de respuesta que el destino devolvió para ese salto.

Campos clave:

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

Paso 4: Prueba diferentes endpoints

FourA ofrece cuatro endpoints para diferentes situaciones:

Endpoint Velocidad Cuándo usarlo
POST /api/auto/ Varía (rápido en hosts activos) No sabes qué motor necesita el sitio. Envía una URL y deja que FourA elija la ruta más económica que funcione.
POST /api/single/ Más rápido (200ms-2s) Páginas estáticas, APIs, sitios renderizados en servidor
POST /api/browser/ Media (2s-10s) Páginas con mucho JavaScript, SPAs, contenido dinámico
POST /api/proxy/ Rápido (1s-5s) Sitios que verifican quién hace la consulta, contenido que varía según el país

Prueba una request automática (la opción inteligente por defecto):

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 una 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 una proxy request (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
    }
  }'

Próximos pasos

Actualizado: 27 de septiembre de 2026
Autenticación →