# Primeros pasos

> Crea una clave de API en el panel y haz tu primera petición a la API de Blogenia en dos minutos.

Versión web: https://blogelia.com/docs/primeros-pasos

Necesitas una cuenta con plan Starter o Pro y al menos un artículo publicado.

## 1. Crea una clave

1. Entra en el [panel](https://app.blogelia.com/api) y abre **API** en el menú.
2. En **Claves**, pulsa **Crear clave** y ponle un nombre que te ayude a reconocerla.
3. Copia la clave. Empieza por `pk_live_` y **solo se muestra una vez**: si la pierdes, crea otra y revoca la anterior.

> **Aviso:** Guarda la clave en una variable de entorno de tu servidor. No la pongas en código que se ejecute en el navegador.

## 2. Localiza el ID de tu blog

Las rutas piden el identificador del blog (24 caracteres hexadecimales). La pantalla **API** del panel muestra un ejemplo de petición que ya lo lleva puesto.

## 3. Haz tu primera petición

Pide los cinco últimos artículos publicados de tu blog:

**Listar artículos**

*curl*

```bash
curl "https://api.blogelia.com/v1/blogs/66f1c0a2b3c4d5e6f7a8b9c0/articles?limit=5" \
  -H "Authorization: Bearer $BLOGENIA_API_KEY"
```

*Node.js*

```js
const res = await fetch('https://api.blogelia.com/v1/blogs/66f1c0a2b3c4d5e6f7a8b9c0/articles?limit=5', {
  headers: { Authorization: 'Bearer ' + process.env.BLOGENIA_API_KEY },
});
if (!res.ok) throw new Error('HTTP ' + res.status);
const body = await res.json();
console.log(body);
```

*Python*

```python
import os
import requests

res = requests.get(
    "https://api.blogelia.com/v1/blogs/66f1c0a2b3c4d5e6f7a8b9c0/articles",
    params={"limit": 5},
    headers={"Authorization": "Bearer " + os.environ["BLOGENIA_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())
```

**Respuesta**

```json
{
  "data": [
    {
      "id": "66f1c0a2b3c4d5e6f7a8b9c1",
      "title": "¿Cuánto cuesta reformar una cocina?",
      "slug": "cuanto-cuesta-reformar-una-cocina",
      "url": "https://reformas-ejemplo.blogelia.com/cuanto-cuesta-reformar-una-cocina",
      "excerpt": "Precios orientativos y qué incluye cada partida.",
      "publishedAt": "2026-10-01T09:00:00.000Z",
      "updatedAt": "2026-10-02T10:30:00.000Z",
      "category": { "slug": "reformas", "name": "Reformas" },
      "coverImage": { "url": "https://cdn.example.com/cover.webp", "alt": "Cocina reformada" },
      "readingMinutes": 5,
      "faqs": [{ "q": "¿Cuánto tarda una reforma?", "a": "Entre dos y cuatro semanas." }]
    }
  ],
  "page": 1,
  "limit": 5,
  "total": 12
}
```

Si ves `401`, revisa la clave. Si ves `403` con `plan_required`, tu cuenta está en Free. Ver [Errores](https://blogelia.com/docs/errores).

## Después

- Pide un artículo completo: [Artículos](https://blogelia.com/docs/articulos).
- Pagina listas largas: [Paginación](https://blogelia.com/docs/paginacion).
- Entérate al momento de cada publicación: [Webhooks](https://blogelia.com/docs/webhooks).