# Inicio rápido

> URL: https://foura.ai/es/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

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

## Requisitos previos

- Una cuenta de FourA ([regístrate aquí](https://foura.ai))
- Tu API key (crea una en el [Dashboard](https://foura.ai/dashboard))

## Paso 1: Obtén tu API Key

Inicia sesión en el [Dashboard](https://foura.ai/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):

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

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

## Paso 3: Lee la response

```json
{
  "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):

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

Prueba una request de navegador:

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

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

```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": 3,
    "request": {
      "method": "GET",
      "url": "https://example.com",
      "unblocker": true
    }
  }'
```

## Próximos pasos

- [Autenticación](https://foura.ai/docs/getting-started/authentication): Gestión y seguridad de API keys
- [Endpoints de la API](https://foura.ai/docs/api/endpoints): Referencia completa de parámetros para los cuatro endpoints
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Cómo decide qué hacer el endpoint auto
- [SDKs y librerías](https://foura.ai/docs/getting-started/sdks-and-libraries): Ejemplos en Python, Node.js, Go y Ruby
- [Elegir el endpoint adecuado](https://foura.ai/docs/guides/choosing-task-type): Cuándo elegir auto, single, browser o proxy
