seoum← На главную
Спецификация / APIv1 · public teaser

API отчётов

Те же данные, что на демо-отчёте лендинга, — машинным способом. Без ключа и регистрации: тизер открыт, платные блоки приходят по подписке.

GET /api/reports/{slug}

Текущий отчёт по бренду: доля голоса, позиции, поэнджинные метрики.

GET /api/reports/{slug}/history

История замеров (снапшоты) — динамика метрик во времени.

Попробовать прямо сейчас

curl https://seoum.tech/api/reports/amocrm

Ответ (сокращённо):

{
  "schema_version": 1,
  "brand": "amoCRM",
  "meta": {
    "engines": ["alice_web", "gigachat", "deepseek", "google_aimode"],
    "window": { "from": "…", "to": "…" }
  },
  "headline": {
    "brand_sov": 0.75,          // доля голоса 0..1
    "brand_rank": 2,
    "n_brands": 13,
    "top_competitor": { "brand": "Битрикс24", "sov": 0.86 }
  },
  "share_of_voice": [ { "brand": "…", "sov": 0.86 }, … ],
  "per_engine": [
    {
      "engine": "alice_web",
      "visibility_rate": 0.77,       // как часто бренд назван
      "recommendation_rate": 0.49,   // как часто рекомендован (оценка)
      "citation_presence_rate": 1.0  // есть ли цитаты-источники
    }, …
  ],
  "locked": true,   // платные блоки скрыты в тизере
  "counts": { "cited_domains": 24, "competitor_gaps": 17 }
}

Условия

Демо-бренды
amocrm · bitrix24 · retailcrm · s2 (ниша CRM, реальные замеры)
Аутентификация
не нужна для тизера; полные блоки отдаются по сессии подписчика
Лимит
120 запросов в минуту с IP; сверх — 429 + заголовок Retry-After
Формат
JSON, UTF-8; schema_version в каждом ответе
Свежесть
meta.window показывает окно замера; данные обновляются автоматически

Нужен доступ по ключу, свой корпус запросов или вертикаль кроме CRM — напишите на hello@seoum.tech: интеграции подключаем под задачу.