Справочник API

Получайте HTML блога и SEO-метаданные в ваш стек. Базовый путь: `/api/v1`.

Контент, который уже есть на вашем сайте

Webhook срабатывают только когда GrowthDailySeo создаёт новый черновик. Уже существующий в CMS контент автоматически не отправляется.

Один раз импортируйте через `GET /posts` с `status=published` (и `status=draft` для черновиков), постранично.
Сохраняйте `updatedAt` и опрашивайте с `updatedAfter`, чтобы не качать весь каталог заново.
Используйте `If-None-Match` с `ETag` ответа, чтобы пропускать неизменённые страницы.

GET/api/v1/sites/:siteId/posts

Пагинированные посты для синхронизации с CMS. По умолчанию возвращает черновики и опубликованные (новые черновики можно импортировать сразу).

Параметры запроса

page — Номер страницы (по умолчанию 1)
pageSize — Элементов на странице, макс. 50 (по умолчанию 12)
search — Фильтр по заголовку без учёта регистра
status — Фильтр: `draft`, `published` или `all` (по умолчанию — черновик + опубликовано, для синхронизации CMS)
language — Код ISO (напр. `en`, `tr`) — совпадает с `language` каждой записи
updatedAfter — Метка ISO 8601 — только записи, обновлённые после этого времени

Ответ 200

{
  "items": [{
    "id": "...",
    "slug": "my-post",
    "title": "...",
    "contentHtml": "<article>...</article>",
    "status": "draft",
    "seo": {
      "metaDescription": "...",
      "ogTitle": "...",
      "ogDescription": "...",
      "keywords": ["..."]
    },
    "faqJsonLd": { "@type": "FAQPage", ... }
  }],
  "page": 1,
  "pageSize": 12,
  "total": 42,
  "totalPages": 4
}

GET/api/v1/sites/:siteId/posts/:slug

Полный payload поста: contentHtml, excerpt, seo, faqJsonLd. Работает для slug черновиков и опубликованных.

GET/api/v1/sites/:siteId/guides/:slug

Возвращает одну опубликованную guide по slug.

Ответ 200 (JSON camelCase)

{
  "id": "...",
  "slug": "my-guide",
  "title": "...",
  "contentHtml": "<article>...</article>",
  "status": "published",
  "publishedAt": "2026-07-21T12:00:00.000Z",
  "updatedAt": "2026-07-21T12:00:00.000Z"
}

GET/api/v1/sites/:siteId/sitemap.xml

XML-карта опубликованных записей и гайдов. Auth: Bearer или `?token=` для краулеров.

GET/api/v1/sites/:siteId/training/export

Потоковая передача строк обучения с opt-in в формате NDJSON (макс. 500). Content-Type: application/x-ndjson.

POST/api/v1/webhooks/test

Отправляет тестовый payload на настроенный URL webhook. Возвращает 400, если URL не задан.

См. коды ошибок