# API de Blogenia

> 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.

Versión web: https://blogelia.com/docs

Blogenia genera y publica los artículos de tu blog. La API te permite usar esos artículos fuera de Blogenia: mostrarlos en tu propia web con tu diseño, copiarlos a otro sistema o alimentar a un agente de IA. Es una API REST que devuelve JSON.

## Qué puedes hacer

- **Leer** tus blogs y sus artículos publicados, en JSON, HTML o Markdown. Ver [Blogs](https://blogelia.com/docs/blogs) y [Artículos](https://blogelia.com/docs/articulos).
- **Consultar tu cuenta y tu analítica**: visitas, ranking de artículos, créditos, artículos en cualquier estado, generaciones, piloto automático y entregas, con claves de permisos limitados. Ver [Construir tu dashboard](https://blogelia.com/docs/construir-dashboard).
- **Recibir avisos** en tu servidor cada vez que se publica un artículo. Ver [Webhooks](https://blogelia.com/docs/webhooks).
- **Publicar en tu propia API**: Blogenia envía cada artículo a la API de tu web. Ver [Publicar en tu propia API](https://blogelia.com/docs/publicar-en-tu-api).

## Lo básico

| Concepto | Valor |
| --- | --- |
| URL base | `https://api.blogelia.com/v1` |
| Formato | JSON en UTF-8. Las fechas son ISO 8601 en UTC y los identificadores, 24 caracteres hexadecimales. |
| Autenticación | Cabecera `Authorization: Bearer pk_live_…`. Ver [Autenticación](https://blogelia.com/docs/autenticacion). |
| Planes | Starter y Pro. El plan Free no tiene API. |
| Límite | 60 peticiones por minuto en Starter y 300 en Pro, por clave. Ver [Límites de uso](https://blogelia.com/docs/limites). |
| Acceso | Solo lectura (rutas `GET`). Cada clave lleva los permisos que eliges al crearla. Ver [Permisos](https://blogelia.com/docs/autenticacion#scopes). |

> **Nota:** Las claves y los webhooks se crean y se gestionan desde el [panel](https://app.blogelia.com/api), no con la API.

## Referencia OpenAPI

La especificación OpenAPI de las rutas que aceptan clave está en [https://api.blogelia.com/docs](https://api.blogelia.com/docs) (Swagger UI) y en formato JSON en [https://api.blogelia.com/docs-json](https://api.blogelia.com/docs-json).

## Siguiente paso

Haz tu primera petición en dos minutos con [Primeros pasos](https://blogelia.com/docs/primeros-pasos).