Menú de la documentación

Desarrolladores

Primeros pasos

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

Ver como Markdown

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

1. Crea una clave

  1. Entra en el panel 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.

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:

Si ves 401, revisa la clave. Si ves 403 con plan_required, tu cuenta está en Free. Ver Errores.

Listar artículos
curl "https://api.blogelia.com/v1/blogs/66f1c0a2b3c4d5e6f7a8b9c0/articles?limit=5" \
  -H "Authorization: Bearer $BLOGENIA_API_KEY"
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);
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
{
  "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
}

Después