Campos de la publicación a devolver, separados por comas. Los nombres desconocidos se ignoran. Incluya content_html para solicitar el cuerpo, que se omite de forma predeterminada.

fields[posts]

Devuelve únicamente las publicaciones del autor especificado.

filter[author_id]

filter[content_type]

Devuelve únicamente las publicaciones publicadas en esta fecha o después de ella. (formato ISO 8601)

filter[published_at_gte]

Devuelve únicamente las publicaciones publicadas en esta fecha o antes de ella. (formato ISO 8601)

filter[published_at_lte]

filter[published]

Filtra por slug. Devuelve únicamente las publicaciones con una coincidencia exacta.

filter[slug]

Devuelve únicamente las publicaciones con la etiqueta especificada.

filter[tag_id]

Especifica los recursos relacionados a incluir, separados por comas

Valores disponibles para Posts:
- `tags` - Etiquetas de la publicación
- `authors` - Autores de la publicación


include

Elementos por página También se acepta el formato JSON:API `page[size]`.

limit

order

Número de página (empezando desde 1) También se acepta el formato JSON:API `page[number]`.

page

sort

Atributos de la API key y scopes concedidos.

Lista de permisos concedidos a la API key

Identificador del tipo de recurso. Siempre `api_keys`.

Carga útil del recurso author que se creará.

Recursos de autor disponibles en el blog.

Nombre visible del autor
- Nombre que se muestra en el blog
- Puede usar un apodo o seudónimo


URL de la imagen de perfil
- Se recomienda subirla al almacenamiento de inblog
- Proporción: 1:1 (cuadrada)
- Tamaño recomendado: 400x400px


Identificador del tipo de recurso
- Valor fijo según el estándar JSON:API
- Siempre "authors"


Carga útil del recurso author que se actualizará.

Código de idioma del blog (ISO 639-1)
- Predeterminado: ko (coreano)
- Se usa en el atributo lang de HTML


Estado de verificación del dominio personalizado

URL del favicon
- Tamaño: 32x32px o 64x64px
- Formato ICO o PNG


ID de medición de Google Analytics 4 conectado al blog

Si Google Search Console está actualmente conectado

URL de la imagen del logotipo
- Tamaño recomendado: 200x50px (horizontal)
- Se recomienda PNG con fondo transparente


URL del logo (obsoleto, use logo en su lugar)

URL de la imagen destacada de Open Graph
- Imagen que se muestra al compartir en redes sociales
- Tamaño recomendado: 1200x630px


Plan de suscripción (solo lectura)
- free: plan gratuito
- team: plan de equipo
- enterprise: plan empresarial


URL de la propiedad de Google Search Console vinculada a este blog

Diferencia horaria respecto a UTC (en horas)
- Corea: 9 (UTC+9)
- Japón: 9 (UTC+9)
- Este de EE. UU.: -5 (UTC-5)


Hora de la última actualización del blog (ISO 8601)

Identificador del tipo de recurso
- Valor fijo según el estándar JSON:API
- Siempre "blogs"


Carga útil del recurso blog que se va a actualizar.

Texto que se muestra en el elemento de navegación del encabezado

URL de destino que se abre al hacer clic en el elemento de navegación

Color de fondo del banner en formato hexadecimal

Texto complementario que se muestra debajo del título del banner

Texto del titular que se muestra en el banner

Color del título del banner en formato hexadecimal

Texto del pie de página que se muestra en la parte inferior del blog

Elementos de navegación del encabezado que se muestran en la parte superior del blog

Carga útil con estilo JSON:API para actualizar la configuración de la interfaz personalizada.

Proporciona cualquier subconjunto de campos para actualizar. Solo se modificarán los campos incluidos.

Carga útil al estilo JSON:API para añadir un dominio personalizado.

Dominio personalizado que se va a conectar. Proporcione solo el nombre de host, sin protocolo.

Dominio personalizado que se guardó en el blog

Respuesta sin procesar de creación de dominio de Vercel. El conjunto exacto de campos varía según el estado actual del dominio en Vercel.

Estado de verificación inicial guardado para el dominio

Indica si el dominio personalizado se eliminó correctamente

Indica si hay un dominio personalizado configurado actualmente para el blog

Dominio personalizado configurado actualmente

Respuesta sin procesar del estado del dominio del proyecto de Vercel

Respuesta sin procesar del intento de verificación de Vercel que se devuelve cuando el dominio aún no está verificado

Estado de verificación almacenado en el registro del blog

Recursos de formulario de la página actual.

Campos del formulario devueltos por la API.

Hora de creación del formulario (formato ISO 8601)

Configuración de notificaciones por correo electrónico

Configuración del mensaje de agradecimiento

Relaciones del formulario con sus respuestas enviadas.

Relación con las respuestas del formulario creadas a partir de este formulario.

Identificador de tipo de recurso. Siempre `forms`.

Recursos de respuesta de formulario de la página actual.

Campos de la respuesta del formulario enviada.

Hora de envío de la respuesta (formato ISO 8601)

Dirección de correo electrónico del remitente

Datos de la respuesta (objeto JSON). Las claves se resuelven a las etiquetas de los campos del formulario (dataLabel o label)

Relaciones con el formulario, la publicación y el blog relacionados.

Relación con el blog que es propietario de la respuesta del formulario.

Relación con el formulario que recopiló esta respuesta.

Relación con la publicación donde se incrustó el formulario, cuando está disponible.

Identificador de tipo de recurso. Siempre `form_responses`.

Metadatos de versión JSON:API incluidos en cada respuesta JSON:API.

Redirect URI que se usará para el callback

Payload del recurso de entrada que se va a crear.

Recursos de entradas para la página actual.

Título del post (incluido cuando include=title)

Filas de métricas de tráfico por post para el rango de fechas solicitado.

Campos principales del post devueltos por la API.

URL canónica (para prevenir contenido duplicado)

"HTML del contenido de la entrada (generado con el editor TipTap)

**Método de generación:**

- inblog usa un editor WYSIWYG basado en TipTap para generar HTML

- Conversión a HTML en tiempo real mediante el método editor.getHTML()

- Todo el contenido se gestiona en unidades de bloque estructuradas

**Etiquetas HTML básicas:**

- Párrafo: `<p>`

- Encabezados: `<h2>`, `<h3>`, `<h4>` (h1, h5, h6 no admitidos)

- Listas: `<ul>`, `<ol>`, `<li>` (anidamiento admitido)

- Estilos de texto: `<strong>`, `<em>`, `<u>`, `<s>`, `<code>`

- Enlaces: `<a>` (sin atributo rel, nofollow eliminado)

- Cita: `<blockquote>`

- Regla horizontal: `<hr>`

- Salto de línea: `<br>`

**Formato avanzado:**

- Resaltado: `<mark>` (varios colores admitidos)
- Color de texto: `<span style="color: #hex;">` - Alineación de texto: `style="text-align: left|center|right;"`
- Bloque de código: `<pre><code class="language-*">` (resaltado de sintaxis admitido)

**Tablas:**

- `<table>`, `<thead>`, `<tbody>`, `<tr>`, `<th>`, `<td>`
- Columnas redimensionables (atributo colwidth)
- Ajuste automático con desplazamiento horizontal

**Bloques personalizados (distinguidos por el atributo data-type):**

- Imagen: `<img data-type="imageBlock">` - Bloque de una sola imagen
- Cuadrícula de imágenes: `<div data-type="imageGrid">` - Diseño en cuadrícula
- Carrusel de imágenes: `<div data-type="imageCarousel">` - Formato de diapositivas
- Llamada de atención: `<div data-type="callOut">` - Cuadro de énfasis
- Botón de enlace: `<div data-type="linkButton">` - Botón CTA
- Marcador: `<div data-type="bookmark">` - Vista previa de URL

**Compatibilidad con incrustaciones:**

- YouTube: `<div data-type="youtube" data-youtube-video-id="*">`
- Servicios de formularios:
  - Google Forms: `<div data-type="googleForm">`
  - HubSpot: `<div data-type="hubspot">`
  - Tally: `<div data-type="tally">`
  - Typeform: `<div data-type="typeform">`
- Bloque de código HTML: `<section data-type="code-block"><div>...</div></section>` - Inserción de HTML personalizado (iframes, etc.). Debe usar la etiqueta `section` + `data-type="code-block"` + un contenedor interno `<div>` para coincidir con el esquema de tiptap. `<div data-type="htmlCodeBlock">` NO funcionará

**Seguridad y limitaciones:**

- Las etiquetas `<script>` se eliminan automáticamente (prevención de XSS)
- Las imágenes deben usar la CDN de inblog (source.inblog.dev)
- Los enlaces a hojas de estilo externas están restringidos
- Los iframes solo se permiten para los servicios de incrustación autorizados

**Ejemplo:**

```html
<h2>Title</h2>
<p>Regular text with <strong>emphasis</strong>, <em>italic</em></p>
<div data-type="imageBlock" data-width="wide">
  <img src="https://source.inblog.dev/..." alt="Description">
</div>
<div data-type="callOut" data-emoji="💡">
  <p>Important information</p>
</div>
<pre><code class="language-javascript">console.log('Hello');</code></pre>
```\n"


Color de fondo del botón CTA (color hex)
- Código hex de 6 dígitos (#RRGGBB)
- Predeterminado: color del tema del blog


Tipo de color de fondo del botón CTA
- custom: usa el color personalizado especificado en cta_color
- preset: usa el color preestablecido del blog
- default: usa el color del tema del blog


URL a la que navegar cuando se hace clic en el botón CTA

Color del texto del botón CTA (color hex)
- Código hex de 6 dígitos (#RRGGBB)
- Predeterminado: #ffffff (blanco)


Tipo de color del texto del botón CTA
- custom: usa el color personalizado especificado en cta_text_color
- default: se calcula automáticamente a partir del contraste del fondo del botón (#ffffff o #000000)
- Enviar cta_text_color sin establecer esto como 'custom' puede hacer que el color sea sobrescrito por el editor


Scripts personalizados insertados en la entrada

Descripción resumida de la entrada (meta descripción SEO)

ID del formulario que se adjuntará a la entrada. Establece null para eliminar el formulario.

Meta descripción SEO (mostrada en los resultados de búsqueda)

Meta título SEO (mostrado en la pestaña del navegador)

Hora de publicación de la entrada (formato ISO 8601)

Identificador único apto para URL. Solo se permiten letras, números y guiones

Título de la entrada (se recomienda menos de 60 caracteres para SEO)

Relaciones de la entrada con tags y autores.

Identificador del tipo de recurso
- Valor fijo según el estándar JSON:API
- Siempre "posts"


Recursos relacionados incluidos junto con la entrada, como tags o autores.

Filas de la serie temporal de tráfico para un solo post.

Payload de recurso de la publicación a actualizar.

Carga útil de la acción de publicación.

Carga útil del recurso de redirección que se va a crear.

Recursos de reglas de redirección para el blog actual.

Campos de la regla de redirección devueltos por la API.

Ruta de origen (origen de la redirección)
- Debe comenzar con /
- Debe ser única
- No se admiten comodines


Tipo de redirección
- 307: Temporary Redirect
- 308: Permanent Redirect


Ruta de destino (destino de la redirección)
- Debe comenzar con /
- También se permiten URLs externas (http:// o https://)


Identificador del tipo de recurso
- Valor fijo según el estándar JSON:API
- Siempre "redirects"


Carga útil del recurso redirect que se actualizará.

Filas de referentes ordenadas por número de visitas.

Identificador de recurso relacionado, array de identificadores de recurso o `null`.

ID de recurso (obligatorio)
- Formato de cadena
- Debe ser único dentro de su tipo

**Importante:** El valor de ejemplo (123) es una muestra. Para uso real:
- Obtener IDs de tags: `GET /v1/tags`
- Obtener IDs de authors: `GET /v1/authors`

Usar IDs inexistentes producirá un error 400.


Tipo de recurso (obligatorio)
- posts, tags, authors, etc.


Código de autorización de OAuth devuelto por Google

Redirect URI usado en el flujo de OAuth. Omítelo para usar el callback predeterminado del panel.

Indica si Search Console está ahora conectado

Indica si el intercambio del token y la operación de guardado se realizaron correctamente

Indica si Search Console permanece conectado después de la operación

Indica si la operación de desconexión se realizó correctamente

Indica si Search Console está conectado actualmente

URL de la propiedad de Search Console conectada. Devuelve `null` cuando no está conectado.

Filas de rendimiento de Search Console para el rango de fechas solicitado.

Carga útil del recurso de tag que se creará.

Nombre del tag (distingue mayúsculas y minúsculas, debe ser único)

Identificador único compatible con URL
- Solo se permiten letras minúsculas, números y guiones
- Puede generarse automáticamente a partir del nombre


Identificador de tipo de recurso
- Valor fijo según el estándar JSON:API
- Siempre "tags"


Carga útil del recurso de tag que se actualizará.

Filas de la serie temporal de tráfico para el rango de fechas solicitado.

Recursos de blog accesibles para el usuario actual.

Atributos del blog visibles para el usuario autenticado.

Idioma principal configurado para el blog

Si el usuario actual tiene permitido publicar posts en este blog

Dominio personalizado conectado, si hay uno configurado

ID numérico del blog serializado como cadena

Identificador del tipo de recurso. Siempre `blogs`.

Usa la API key como token Bearer.

Formato: `Authorization: Bearer YOUR_API_KEY`

Las API keys se pueden generar desde el panel de Inblog.


Usa un JWT de usuario firmado como token Bearer.

Formato: `Authorization: Bearer USER_JWT`

Este esquema se utiliza para endpoints con alcance de usuario como `/user/blogs`.


Inblog Support

Gestiona el contenido del blog usando la Inblog API.

## 🚀 Primeros pasos

### 1. Obtener la API key
Obtén tu API key desde el panel:
1. Inicia sesión en [Inblog Dashboard](https://inblog.ai/dashboard)
2. Ve a Settings → API Keys
3. Haz clic en el botón "Create New API Key"
4. Selecciona los scopes de permisos necesarios
5. Guarda tu API key de forma segura

### 2. Primera petición
```bash
curl -X GET https://api.inblog.ai/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 3. Usar las herramientas de desarrollo de npm
Si prefieres no llamar a la API manualmente, instala la CLI:
```bash
npm install -g @inblog/cli
inblog auth login
```
Para asistentes de programación con IA, instala AI Skills:
```bash
npx @inblog/ai-skills
```
La CLI gestiona posts, imágenes, tags, autores, redirecciones, formularios, analíticas y la configuración del blog desde tu terminal. AI Skills instala flujos de trabajo de Inblog para herramientas como Codex, Claude Code, Cursor, GitHub Copilot y Gemini.
Lee la [guía de Developer Tools](/docs/developer-tools/inblog-cli-and-ai-skills).

### 4. Content-Type
- **Request**: `Content-Type: application/json` o `application/vnd.api+json`
- **Response**: `Content-Type: application/vnd.api+json`

## 📋 Funciones principales

- **Gestión de posts**: crea, actualiza, elimina y publica posts
- **Tags y autores**: gestiona categorías e información de autores
- **Configuración del blog**: modifica los ajustes básicos
- **Redirecciones de URL**: configura redirecciones 307 (temporal) y 308 (permanente)
- **Formularios y respuestas**: consulta formularios de captación de leads y datos de envíos
- **Estándar JSON:API**: formato de respuesta consistente

## 🔐 Autenticación

Todas las peticiones a la API requieren autenticación mediante Bearer token a través de la cabecera Authorization:

```
Authorization: Bearer YOUR_API_KEY
```
## 📚 Más información

- [Especificación JSON:API](https://jsonapi.org/)

Proprietary

Inblog API

Recupera todos los perfiles de autor registrados en el blog.

Lista de autores recuperada correctamente

Quita las asociaciones del autor de las publicaciones de este blog. El perfil del autor en si no se elimina.

Recupera la informacion de perfil de un autor especifico.

Actualiza la informacion de perfil de un autor.

**Campos editables:**
- author_name: Nombre visible del autor
- avatar_url: URL de la imagen de perfil

**Procesamiento de imagenes:**
Las URL de imagenes de perfil se suben al almacenamiento R2 de Inblog de forma predeterminada.
Para conservar las URL originales, usa el parametro de consulta `preserve_external_images=true`.


Conserva las URL de imagenes externas en lugar de subirlas al almacenamiento R2

preserve_external_images

Actualiza la informacion de perfil de un autor usando PUT.

**Campos editables:**
- author_name: Nombre visible del autor
- avatar_url: URL de la imagen de perfil

**Procesamiento de imagenes:**
Las URL de imagenes de perfil se suben al almacenamiento R2 de Inblog de forma predeterminada.
Para conservar las URL originales, usa el parametro de consulta `preserve_external_images=true`.


Obtén métricas de rendimiento por publicación, incluidas visitas, clics, tráfico orgánico y tasa de conversión.

Fecha de inicio (YYYY-MM-DD). El valor predeterminado es hace 28 días.

start_date

Fecha de fin (YYYY-MM-DD). El valor predeterminado es hoy.

end_date

Establece "title" para incluir los títulos de las publicaciones en la respuesta

Métricas de publicaciones obtenidas correctamente

Obtener métricas de rendimiento de publicaciones

Obtén los datos de tráfico a lo largo del tiempo para una publicación específica con granularidad diaria u horaria.

Intervalo de tiempo para la agregación de datos

interval

Datos de tráfico de la publicación obtenidos correctamente

Obtén el análisis de fuentes de tráfico para una publicación específica mostrando los datos de referrer.

Fuentes de tráfico de la publicación obtenidas correctamente

Obtener fuentes de tráfico de la publicación

Obtén el análisis de fuentes de tráfico mostrando los datos de referrer ordenados por número de visitas.

Fuentes de tráfico obtenidas correctamente

Obtiene datos de tráfico de todo el blog con granularidad diaria u horaria. Incluye visitas, clicks, tráfico orgánico y desgloses por tipo de página.

Fecha de inicio (YYYY-MM-DD). Por defecto, hace 28 días.

Fecha de fin (YYYY-MM-DD). Por defecto, hoy.

type

Datos de tráfico obtenidos correctamente

Recupera la configuración actual del banner y la personalización de la UI de tu blog.

Configuración de la UI obtenida correctamente

Obtener configuración del banner y la UI

Actualiza la configuración del banner y de personalización de la interfaz. Solo se actualizarán los campos proporcionados.

Configuración de interfaz actualizada correctamente

Actualizar configuración de banner e interfaz

Elimina el dominio personalizado de tu blog. El blog volverá al subdominio predeterminado.

Dominio personalizado eliminado correctamente

Comprueba la configuración actual del dominio personalizado y el estado de verificación de DNS.

Estado del dominio obtenido correctamente

Añade un dominio personalizado a tu blog. Devuelve la configuración del dominio, incluidos los ajustes de DNS de Vercel necesarios para la verificación.

Dominio personalizado añadido correctamente

Recupera informacion sobre el blog conectado a la API key actual.

Actualiza la configuracion basica como el nombre del blog, la descripcion, el logo, el favicon y la imagen destacada.

**Procesamiento de imagenes:**
Las URL del logo, el favicon y la imagen destacada se suben al almacenamiento R2 de Inblog de forma predeterminada.
Para conservar las URL originales, usa el parametro de consulta `preserve_external_images=true`.


Actualiza la configuracion basica como el nombre del blog, la descripcion, el logo, el favicon y la imagen destacada usando PUT.

**Procesamiento de imagenes:**
Las URL del logo, el favicon y la imagen destacada se suben al almacenamiento R2 de Inblog de forma predeterminada.
Para conservar las URL originales, usa el parametro de consulta `preserve_external_images=true`.


Actualizar la configuracion de mi blog (PUT)

Intercambia un código de autorización de OAuth por tokens para completar la conexión de Search Console.

Desconecta Google Search Console de tu blog. Elimina los tokens de OAuth almacenados.

Search Console desconectado correctamente