Docs › Primeros pasos › Guía de inicio rápido

Guía de inicio rápido

Pase de cero a su primera recopilación de datos en menos de dos minutos.

Requisitos previos

Paso 1: Obtener su API key

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

Cópiela. La necesitará para cada request.

Paso 2: Realizar su primer request

Abra una terminal y ejecute esto (reemplace YOUR_API_KEY con su clave 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: Leer la response

{
  "status": 200,
  "headers": [["content-type", "text/html"]],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

Campos clave:

  • 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 del request en segundos

Paso 4: Probar diferentes endpoints

FourA tiene tres endpoints para diferentes situaciones:

Endpoint Velocidad Cuándo usarlo
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

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

Pruebe 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 →