Список полей записи через запятую. Неизвестные имена игнорируются. Добавьте content_html, чтобы запросить тело записи, которое по умолчанию не возвращается.

fields[posts]

Возвращает только посты указанного автора.

filter[author_id]

Фильтрация по типу контента.

filter[content_type]

Возвращает только посты, опубликованные в эту дату или позже. (формат ISO 8601)

filter[published_at_gte]

Возвращает только посты, опубликованные в эту дату или раньше. (формат ISO 8601)

filter[published_at_lte]

Фильтрация по статусу публикации.

filter[published]

Фильтрация по slug. Возвращает только посты с точным совпадением.

filter[slug]

Возвращает только посты с указанным тегом.

filter[tag_id]

Укажите связанные ресурсы для включения, разделяя их запятыми

Доступные значения для Posts:
- `tags` - теги поста
- `authors` - авторы поста


include

Элементов на странице Также принимается формат JSON:API `page[size]`.

limit

Направление сортировки.

order

Номер страницы (начиная с 1) Также принимается формат JSON:API `page[number]`.

page

sort

Внутренняя ошибка сервера

Ошибка аутентификации

Атрибуты API key и предоставленные scopes.

Список разрешений, предоставленных для API key

Поддомен подключённого блога

Идентификатор типа ресурса. Всегда `api_keys`.

Полезная нагрузка ресурса автора для создания.

Ресурсы авторов, доступные в блоге.

Поля автора, возвращаемые API.

Отображаемое имя автора
- Имя, отображаемое в блоге
- Можно использовать никнейм или псевдоним


URL изображения профиля
- Рекомендуется загружать в хранилище Inblog
- Соотношение сторон: 1:1 (квадрат)
- Рекомендуемый размер: 400x400px


Идентификатор типа ресурса
- Фиксированное значение согласно стандарту JSON:API
- Всегда "authors"


Полезная нагрузка ресурса автора для обновления.

Поля блога, возвращаемые API.

Код языка блога (ISO 639-1)
- По умолчанию: ko (корейский)
- Используется в атрибуте lang тега HTML


Время создания блога (ISO 8601)

Пользовательский домен

Статус проверки пользовательского домена

Пользовательский подкаталог

URL фавикона
- Размер: 32x32px или 64x64px
- Формат ICO или PNG


Идентификатор отслеживания Google Analytics 4, подключённый к блогу

Подключён ли в настоящее время Google Search Console

URL изображения логотипа
- Рекомендуемый размер: 200x50px (горизонтальный)
- Рекомендуется PNG с прозрачным фоном


URL логотипа (устарело, используйте logo вместо него)

URL изображения Open Graph
- Изображение, отображаемое при публикации в социальных сетях
- Рекомендуемый размер: 1200x630px


План подписки (только для чтения)
- free: бесплатный план
- team: командный план
- enterprise: корпоративный план


URL ресурса Google Search Console, привязанного к этому блогу

Разница во времени относительно UTC (в часах)
- Корея: 9 (UTC+9)
- Япония: 9 (UTC+9)
- Восточное время США: -5 (UTC-5)


Время последнего обновления блога (ISO 8601)

Идентификатор типа ресурса
- Фиксированное значение согласно стандарту JSON:API
- Всегда "blogs"


Полезная нагрузка ресурса блога для обновления.

Текст, отображаемый в элементе навигации в шапке

URL назначения, открываемый при клике по элементу навигации

Цвет фона баннера в шестнадцатеричном формате

Стиль отображения баннера

Вспомогательный текст, отображаемый под заголовком баннера

Текст заголовка, отображаемый на баннере

Цвет заголовка баннера в шестнадцатеричном формате

URL изображения баннера

Текст подвала, отображаемый в нижней части блога

Элементы навигации в шапке, отображаемые в верхней части блога

Полезная нагрузка в стиле JSON:API для обновления настроек пользовательского интерфейса.

Укажите любое подмножество полей для обновления. Будут изменены только переданные поля.

Конечная дата диапазона данных

Начальная дата диапазона данных

Общее количество результатов

Полезная нагрузка в стиле JSON:API для добавления пользовательского домена.

Пользовательский домен для подключения. Укажите только hostname, без протокола.

Пользовательский домен, сохранённый для блога

Необработанный ответ Vercel о создании домена. Точный набор полей зависит от текущего состояния домена в Vercel.

Начальное состояние проверки, сохранённое для домена

Был ли пользовательский домен успешно удалён

Настроен ли в данный момент пользовательский домен для блога

Настроенный в данный момент пользовательский домен

Необработанный ответ Vercel о статусе домена в проекте

Необработанный ответ Vercel о попытке проверки, возвращаемый, когда домен ещё не проверен

Состояние проверки, сохранённое в записи блога

Подробное сообщение об ошибке

Список объектов ошибок JSON:API.

Ресурсы форм для текущей страницы.

Поля формы, возвращаемые API.

Время создания формы (формат ISO 8601)

Объект конфигурации формы

Источник файла лид-магнита

URL для загрузки лид-магнита

Количество ответов на форму

Настройки уведомлений по email

Настройки сообщения с благодарностью

Связи формы с отправленными ответами.

Связь с ответами формы, созданными из этой формы.

Идентификатор типа ресурса. Всегда `forms`.

Ресурсы ответов формы для текущей страницы.

Поля отправленного ответа формы.

Время отправки ответа (формат ISO 8601)

Данные ответа (JSON object). Ключи преобразуются в подписи полей формы (dataLabel или label)

Часовой пояс отправителя

Связи со связанными формой, постом и блогом.

Связь с блогом, которому принадлежит ответ формы.

Связь с формой, которая собрала этот ответ.

Связь с постом, в который была встроена форма, если доступно.

Идентификатор типа ресурса. Всегда `form_responses`.

Метаданные версии JSON:API, включаемые в каждый ответ JSON:API.

Реализованная версия JSON:API.

Redirect URI, который будет использоваться для обратного вызова

URL страницы согласия Google OAuth

Полезная нагрузка ресурса поста для создания.

Ресурсы постов для текущей страницы.

Включённые связанные ресурсы

Коэффициент конверсии

Посещения из органического поиска

Заголовок поста (включается при include=title)

Строки метрик трафика по каждому посту за запрошенный диапазон дат.

Основные поля поста, возвращаемые API.

Канонический URL (для предотвращения дублирования контента)

"Post content HTML (контент поста в формате HTML, сгенерирован редактором TipTap)

**Generation Method:**

- inblog использует редактор TipTap (WYSIWYG) для генерации HTML

- Преобразование в HTML в реальном времени с помощью метода editor.getHTML()

- Весь контент управляется в виде структурированных блоков

**Basic HTML Tags:**

- Параграф: `<p>`

- Заголовки: `<h2>`, `<h3>`, `<h4>` (h1, h5, h6 не поддерживаются)

- Списки: `<ul>`, `<ol>`, `<li>` (вложенность поддерживается)

- Стили текста: `<strong>`, `<em>`, `<u>`, `<s>`, `<code>`

- Ссылки: `<a>` (без атрибута rel, nofollow удаляется)

- Цитата: `<blockquote>`

- Горизонтальная линия: `<hr>`

- Перенос строки: `<br>`

**Advanced Formatting:**

- Выделение: `<mark>` (поддерживается несколько цветов)
- Цвет текста: `<span style="color: #hex;">` - Выравнивание текста: `style="text-align: left|center|right;"`
- Блок кода: `<pre><code class="language-*">` (поддерживается подсветка синтаксиса)

**Tables:**

- `<table>`, `<thead>`, `<tbody>`, `<tr>`, `<th>`, `<td>`
- Столбцы с изменяемой шириной (атрибут colwidth)
- Автоматическая обёртка с горизонтальной прокруткой

**Custom Blocks (различаются по атрибуту data-type):**

- Изображение: `<img data-type="imageBlock">` - блок одного изображения
- Сетка изображений: `<div data-type="imageGrid">` - макет в виде сетки
- Карусель изображений: `<div data-type="imageCarousel">` - формат слайдов
- Выноска: `<div data-type="callOut">` - блок акцента
- Кнопка-ссылка: `<div data-type="linkButton">` - кнопка CTA
- Закладка: `<div data-type="bookmark">` - предпросмотр URL

**Embed Support:**

- YouTube: `<div data-type="youtube" data-youtube-video-id="*">`
- Сервисы форм:
  - Google Forms: `<div data-type="googleForm">`
  - HubSpot: `<div data-type="hubspot">`
  - Tally: `<div data-type="tally">`
  - Typeform: `<div data-type="typeform">`
- HTML-блок кода: `<section data-type="code-block"><div>...</div></section>` - вставка произвольного HTML (iframe и т. п.). Необходимо использовать тег `section` + `data-type="code-block"` + внутреннюю обёртку `<div>`, чтобы соответствовать схеме tiptap. `<div data-type="htmlCodeBlock">` работать НЕ будет

**Security and Limitations:**

- Теги `<script>` автоматически удаляются (защита от XSS)
- Для изображений следует использовать inblog CDN (source.inblog.dev)
- Ссылки на внешние таблицы стилей ограничены
- iframe разрешены только для допустимых сервисов встраивания

**Example:**

```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"


Цвет фона кнопки CTA (hex-цвет)
- 6-значный hex-код (#RRGGBB)
- По умолчанию: цвет темы блога


Тип цвета фона кнопки CTA
- custom: использовать пользовательский цвет, указанный в cta_color
- preset: использовать предустановленный цвет блога
- default: использовать цвет темы блога


URL для перехода при нажатии кнопки CTA

Цвет текста кнопки CTA (hex-цвет)
- 6-значный hex-код (#RRGGBB)
- По умолчанию: #ffffff (белый)


Тип цвета текста кнопки CTA
- custom: использовать пользовательский цвет, указанный в cta_text_color
- default: вычисляется автоматически на основе контраста с фоном кнопки (#ffffff или #000000)
- Отправка cta_text_color без установки этого значения в 'custom' может привести к тому, что цвет будет переопределён редактором


Пользовательские скрипты, вставляемые в пост

Краткое описание поста (meta description для SEO)

ID формы для прикрепления к посту. Установите null, чтобы убрать форму.

Информация об обложке (featured image)

SEO meta description (отображается в результатах поиска)

SEO meta title (отображается во вкладке браузера)

Время публикации поста (формат ISO 8601)

Уникальный идентификатор, дружественный к URL. Допускаются только буквы, цифры и дефисы

Заголовок поста (для SEO рекомендуется не более 60 символов)

Связи поста с тегами и авторами.

Идентификатор типа ресурса
- Фиксированное значение согласно стандарту JSON:API
- Всегда "posts"


Связанные ресурсы, включённые вместе с постом, например теги или авторы.

Строки временного ряда трафика для отдельного поста.

Полезная нагрузка ресурса поста для обновления.

Полезная нагрузка действия публикации.

Полезная нагрузка ресурса редиректа для создания.

Ресурсы правил редиректа для текущего блога.

Поля правила редиректа, возвращаемые API.

Исходный путь (источник редиректа)
- Должен начинаться с /
- Должен быть уникальным
- Подстановочные знаки не поддерживаются


Тип редиректа
- 307: Temporary Redirect
- 308: Permanent Redirect


Целевой путь (назначение редиректа)
- Должен начинаться с /
- Также допускаются внешние URL (http:// или https://)


Идентификатор редиректа

Идентификатор типа ресурса
- Фиксированное значение согласно стандарту JSON:API
- Всегда "redirects"


Полезная нагрузка ресурса redirect для обновления.

Строки рефереров, ранжированные по количеству посещений.

Количество посещений из этого источника

Домен или источник реферера

Идентификатор связанного ресурса, массив идентификаторов ресурсов или `null`.

ID ресурса (обязательно)
- Строковый формат
- Должен быть уникальным в пределах своего типа

**Важно:** Пример значения (123) приведён для образца. Для реального использования:
- Получить ID тегов: `GET /v1/tags`
- Получить ID авторов: `GET /v1/authors`

Использование несуществующих ID приведёт к ошибке 400.


Тип ресурса (обязательно)
- posts, tags, authors и т. д.


Код авторизации OAuth, возвращённый Google

Redirect URI, используемый в потоке OAuth. Не указывайте его, чтобы использовать обратный вызов панели управления по умолчанию.

Подключён ли теперь Search Console

Удался ли обмен токена и операция сохранения

Остаётся ли Search Console подключённым после выполнения операции

Удалась ли операция отключения

Подключён ли Search Console в настоящий момент

URL подключённого ресурса Search Console. Возвращает `null`, если подключение отсутствует.

Строки эффективности Search Console за запрошенный диапазон дат.

Показатель кликабельности (0-1)

Ключевое слово или URL страницы

Средняя позиция в поиске

Полезная нагрузка ресурса тега для создания.

Ресурсы тегов для текущего блога.

Поля тега, возвращаемые API.

Имя тега (с учётом регистра, должно быть уникальным)

URL-дружественный уникальный идентификатор
- Допускаются только строчные буквы, цифры и дефисы
- Может быть автоматически сгенерирован из name


Идентификатор типа ресурса
- Фиксированное значение согласно стандарту JSON:API
- Всегда "tags"


Полезная нагрузка ресурса тега для обновления.

Строки временного ряда трафика за запрошенный диапазон дат.

Дата или дата и время точки данных

Посещения главной страницы

Посещения страницы поста

Публичный URL загруженного ресурса

Доступные ресурсы блогов для текущего пользователя.

Атрибуты блога, видимые аутентифицированному пользователю.

Основной язык, настроенный для блога

Разрешено ли текущему пользователю публиковать посты в этом блоге

Подключённый пользовательский домен, если он настроен

Права текущего пользователя в блоге

Текущий тарифный план подписки для блога

Числовой ID блога, сериализованный в виде строки

Идентификатор типа ресурса. Всегда `blogs`.

Используйте API key в качестве Bearer token.

Формат: `Authorization: Bearer YOUR_API_KEY`

API keys можно сгенерировать в панели управления inblog.


Используйте подписанный пользовательский JWT в качестве Bearer token.

Формат: `Authorization: Bearer USER_JWT`

Эта схема используется для эндпоинтов с пользовательской областью видимости, таких как `/user/blogs`.


Inblog Support

Управление содержимым блога с помощью Inblog API.

## 🚀 Начало работы

### 1. Получите API key
Получите свой API key в панели управления:
1. Войдите в [Inblog Dashboard](https://inblog.ai/dashboard)
2. Перейдите в Settings → API Keys
3. Нажмите кнопку "Create New API Key"
4. Выберите необходимые области разрешений
5. Надёжно сохраните свой API key

### 2. Первый запрос
```bash
curl -X GET https://api.inblog.ai/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 3. Используйте инструменты разработчика npm
Если вы предпочитаете не вызывать API вручную, установите CLI:
```bash
npm install -g @inblog/cli
inblog auth login
```
Для ИИ-ассистентов по программированию установите AI Skills:
```bash
npx @inblog/ai-skills
```
CLI управляет постами, изображениями, тегами, авторами, редиректами, формами, аналитикой и настройками блога прямо из терминала. AI Skills устанавливают рабочие процессы Inblog для таких инструментов, как Codex, Claude Code, Cursor, GitHub Copilot и Gemini.
Прочитайте [руководство по инструментам разработчика](/docs/developer-tools/inblog-cli-and-ai-skills).

### 4. Content-Type
- **Запрос**: `Content-Type: application/json` или `application/vnd.api+json`
- **Ответ**: `Content-Type: application/vnd.api+json`

## 📋 Основные возможности

- **Управление постами**: создание, обновление, удаление и публикация постов
- **Теги и авторы**: управление категориями и информацией об авторах
- **Настройки блога**: изменение базовых настроек
- **URL-редиректы**: настройка редиректов 307 (временный) и 308 (постоянный)
- **Формы и ответы**: просмотр форм для сбора лидов и данных отправки
- **Стандарт JSON:API**: единообразный формат ответа

## 🔐 Аутентификация

Все запросы к API требуют аутентификации по Bearer-токену через заголовок Authorization:

```
Authorization: Bearer YOUR_API_KEY
```
## 📚 Узнать больше

- [Спецификация JSON:API](https://jsonapi.org/)

Proprietary

Inblog API

Получить все профили авторов, зарегистрированные в блоге.

Список авторов успешно получен

Удалить связи автора с постами в этом блоге. Сам профиль автора при этом не удаляется.

Удалить автора из блога

Получить информацию профиля конкретного автора.

Обновить информацию профиля автора.

**Редактируемые поля:**
- author_name: Отображаемое имя автора
- avatar_url: URL изображения профиля

**Обработка изображений:**
По умолчанию URL изображений профиля загружаются в хранилище Inblog R2.
Чтобы сохранить исходные URL, используйте query-параметр `preserve_external_images=true`.


Сохранить внешние URL изображений вместо загрузки в хранилище R2