# Blogenia

> Blogenia genera y publica blogs SEO para pymes. Su API REST (solo lectura, JSON) devuelve los blogs y artículos publicados; además hay webhooks firmados y publicación en una API propia.

La URL base de la API es `https://api.blogelia.com/v1`. Se autentica con `Authorization: Bearer pk_live_…`. Cada página de la documentación está disponible en Markdown añadiendo `.md`.

## Empezar

- [API de Blogenia](https://blogelia.com/docs/introduccion.md): Lee los artículos publicados de tus blogs de Blogenia desde tu web o tu app, recibe avisos con webhooks y publica en tu propia API.
- [Primeros pasos](https://blogelia.com/docs/primeros-pasos.md): Crea una clave de API en el panel y haz tu primera petición a la API de Blogenia en dos minutos.
- [Recibir el contenido en tu web](https://blogelia.com/docs/recibir-contenido.md): Guía paso a paso para llevar los artículos de Blogenia a tu propia web: leer con la API, reaccionar a un webhook o dejar que Blogenia publique en tu API.
- [Construir tu dashboard](https://blogelia.com/docs/construir-dashboard.md): Guía para llevar las visitas y los artículos de Blogenia a tu propio dashboard: qué rutas llamar, cuánto cachear y un ejemplo en Node.js.

## Conceptos

- [Autenticación](https://blogelia.com/docs/autenticacion.md): Cómo autenticarte en la API de Blogenia con una clave pk_live_ en la cabecera Authorization.
- [Seguridad](https://blogelia.com/docs/seguridad.md): Lista de comprobación para integrar la API, los webhooks y la publicación en tu propia API de Blogenia con el menor riesgo posible.
- [Límites de uso](https://blogelia.com/docs/limites.md): Peticiones por minuto de la API de Blogenia según el plan, cabeceras X-RateLimit y qué hacer ante un 429.
- [Errores](https://blogelia.com/docs/errores.md): Forma de las respuestas de error de la API de Blogenia, códigos HTTP y códigos de error propios.
- [Paginación](https://blogelia.com/docs/paginacion.md): Cómo paginar la lista de artículos de la API de Blogenia con page y limit, y cómo sincronizar solo las novedades.

## API de lectura

- [Blogs](https://blogelia.com/docs/blogs.md): Endpoint GET /blogs/{blogId} de la API de Blogenia: datos públicos de un blog de tu organización.
- [Artículos](https://blogelia.com/docs/articulos.md): Endpoints GET /blogs/{blogId}/articles y GET /articles/{id} de la API de Blogenia: lista paginada y artículo completo en JSON, HTML o Markdown.
- [Cuenta](https://blogelia.com/docs/cuenta.md): Endpoints GET /account y GET /account/credits/ledger de la API de Blogenia: plan, créditos, uso del mes, límites, blogs y movimientos de créditos.
- [Analítica](https://blogelia.com/docs/analitica.md): Visitas de tus blogs y artículos por la API de Blogenia: series por día, semana o mes, ranking de artículos y total de la cuenta con el permiso stats:read.
- [Artículos (todos los estados)](https://blogelia.com/docs/articulos-todos.md): Lista y resumen de los artículos de un blog de Blogenia en cualquier estado (borrador, programado, publicado…) con el permiso account:read.
- [Generaciones](https://blogelia.com/docs/generaciones.md): Historial de generaciones de artículos de un blog de Blogenia por API: estado, pasos, créditos y código de error, con el permiso account:read.
- [Piloto automático](https://blogelia.com/docs/piloto-automatico.md): Configuración, próximos huecos y últimos resultados del piloto automático de un blog de Blogenia por API, con el permiso account:read.
- [Entregas](https://blogelia.com/docs/entregas.md): Estado de la publicación externa (WordPress o tu API) y de las entregas de webhooks de Blogenia por API, con el permiso account:read.

## Integraciones

- [Webhooks](https://blogelia.com/docs/webhooks.md): Recibe un POST firmado en tu servidor cada vez que Blogenia publica un artículo. Eventos, firma HMAC, ejemplos en Node, Python y PHP, y reintentos.
- [Publicar en tu propia API](https://blogelia.com/docs/publicar-en-tu-api.md): Contrato HTTP que debe implementar tu web para que Blogenia le envíe los artículos: rutas, cabeceras, cuerpo, respuesta, tiempos y reintentos, con un receptor de ejemplo.

## Más

- [Para agentes de IA](https://blogelia.com/docs/agentes-ia.md): Cómo usan los agentes de IA la documentación de Blogenia: versión Markdown de cada página, llms.txt, llms-full.txt y la especificación OpenAPI.
- [Changelog](https://blogelia.com/docs/changelog.md): Historial de versiones de la API pública de Blogenia: qué incluye la versión actual, v1.

## Opcional

- [Toda la documentación en un solo documento](https://blogelia.com/llms-full.txt)
- [Especificación OpenAPI](https://api.blogelia.com/docs-json)