Данные и интеграции

API и данные

Рабочая точка входа в JSON, пакетные выгрузки и машинный контур Qaz.Vision. Здесь важнее не перечень ссылок, а быстрый ответ на вопрос: какой адрес брать под конкретную задачу.

Корпус 296

документов доступны через публичный API

Тезисы 2161

атомов доступны для поиска и NDJSON-выгрузки

Корпуса 4

публичных корпусных среза в текущем контуре

Свежесть 0 дн.

Последнее подтвержденное событие находится в ожидаемом окне; явного сигнала о пропуске свежих материалов нет.

Быстрый маршрут
Куда идти на этой странице

Что брать первым по задаче

Машинные входы

Минимальный набор для машинного потребления без лишнего обхода по сайту.

/ai.json manifest правила, свежесть, адреса и пакетные выгрузки
/api/snapshots/latest.json snapshot текущая версия корпуса и версия для зеркалирования
/status.json статус свежесть корпуса, Janus и последние документы

Покрытие по корпусам

Быстрый срез по объему доступных материалов на API-слое.

Касым-Жомарт Токаев Президентский корпус
Документы 195
Тезисы 1443
Ерлан Карин Корпус госсоветника
Документы 30
Тезисы 210
Маулен Ашимбаев Сенатский корпус
Документы 39
Тезисы 344
Корпус премьер-министров Казахстана Правительственный корпус
Документы 32
Тезисы 164

Живые разделы и входы в данные

Матрица по адресам API

Задача Endpoint Формат Когда брать
Список документов /api/documents JSON Когда нужен фильтруемый список материалов по спикеру, году, тегу или поиску
Карточка документа /api/documents/{id} JSON Когда нужен полный metadata-layer по одному документу
Тезисы и цитаты /api/atoms JSON Когда нужен атомизированный смысловой слой с блоками и тегами
Хронология /api/timeline JSON Когда нужна temporal-лента без полного корпуса
Справочники /api/tags, /api/theme-blocks, /api/sources JSON Когда нужно строить навигацию, фильтры и mapping-слой
Агрегаты и health /api/stats, /status.json JSON Когда нужна сводка, health-check или внешняя проверка свежести

Пакетные и AI-выгрузки

Слой Адрес Назначение Примечание
AI manifest /ai.json Точка входа для агентных и языковых систем Содержит правила, снимок свежести, пакетные выгрузки и discovery-данные
Пакетный корпус /api/bulk/corpus.ndjson Полная NDJSON-выгрузка корпуса Предпочтительный поток для RAG и переиндексации
Language slices /api/bulk/ru/corpus.ndjson, /api/bulk/kk/corpus.ndjson, /api/bulk/en/corpus.ndjson Языковые срезы Удобны, если не нужно тянуть весь multilingual слой
Documents / atoms /api/bulk/documents.ndjson, /api/bulk/atoms.ndjson Раздельные потоковые выгрузки Удобны для selective pipelines
Snapshot /api/snapshots/latest.json Контроль версии корпуса Нужен для безопасной переиндексации без дрейфа

Ключевые поля

speaker — корпус спикера, source_type — тип документа, theme_block_code — тематический блок A–G, tags — теги для тематической навигации, is_key_quote — признак опорного тезиса, event_date — дата публикации или выступления, canonical_url и source_urls — ссылки для корректного цитирования.

Допустимые значения speaker в API: TOKAEV, KARIN, ASHIMBAYEV, BEKTENOV. Для удобства также принимаются распространённые алиасы: tokayev, president, prezident, karin, ashimbaev, ashimbayev, bektenov, prime_minister. На публичном фронте при этом дополнительно существуют отдельные маршруты корпуса премьер-министров /premiery и персонального корпуса /bektenov.

Последние подтвержденные документы

Происхождение данных и границы API

Публичный API отражает текущий опубликованный срез данных по четырем базовым спикерным кодам. На фронте этот слой может быть собран в отдельные ролевые и персональные корпуса, чтобы не смешивать должность и человека. В ответы попадают только документы и тезисы, прошедшие публикацию в Qaz.Vision. Дополнительная разметка, языковые версии и уточнение тезисов могут появляться позже без смены идентичности документа.

API не стоит трактовать как универсальный архив всех медийных упоминаний или внешних интерпретаций. Отсутствие материала в публичном срезе не означает отсутствия события или позиции вне текущего подтвержденного корпуса.

Форматы выдачи

Для просмотра в браузере используйте pretty JSON. Для выгрузки в файл используйте скачивание JSON. Для ИИ-индексации и RAG используйте bulk corpus NDJSON, языковые срезы RU, KK, EN, отдельные выгрузки документов и тезисов или snapshot manifest.

Куда дальше
Следующие рабочие входы