документов доступны через публичный API
Данные и интеграции
API и данные
Рабочая точка входа в JSON, пакетные выгрузки и машинный контур Qaz.Vision. Здесь важнее не перечень ссылок, а быстрый ответ на вопрос: какой адрес брать под конкретную задачу.
атомов доступны для поиска и NDJSON-выгрузки
публичных корпусных среза в текущем контуре
Последнее подтвержденное событие находится в ожидаемом окне; явного сигнала о пропуске свежих материалов нет.
Что брать первым по задаче
Для редакционной и аналитической работы сначала открывайте публичные корпуса, а затем уже переходите к JSON-данным.
Для интеграций и разработки сначала берите спецификацию, а не вручную собранный список ссылок.
Для RAG и обхода системами ИИ берите manifest, snapshot и пакетные выгрузки. HTML здесь вспомогательный, а не основной слой.
Машинные входы
Минимальный набор для машинного потребления без лишнего обхода по сайту.
Покрытие по корпусам
Быстрый срез по объему доступных материалов на API-слое.
Живые разделы и входы в данные
Матрица по адресам 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.