Документация API
Открытый API для доступа к данным ortcom.kz. Новости, АнтиФейк, события и регионы.
https://ortcom.qdev.run/api/v1/
Обзор
ortcom.kz Public API обеспечивает программный доступ к новостям, данным АнтиФейк-центра, пресс-мероприятиям и региональной информации. API построен на RESTful-принципах и возвращает данные в формате JSON.
Аутентификация
В текущей версии API работает без аутентификации. Все публичные данные свободно доступны. В будущем будет добавлен расширенный доступ через API-ключи.
Пагинация
Все endpoints со списками поддерживают пагинацию:
/api/v1/articles?page=2&limit=10
{
"api_version": "1.0.0",
"meta": {
"total": 1250,
"page": 2,
"per_page": 10,
"pages": 125
},
"data": [...]
}| Параметр | Тип | Описание |
|---|---|---|
page | int | Номер страницы (от 1) |
limit | int | Элементов на странице (макс. 100) |
Ошибки
| Код | Описание |
|---|---|
200 | Успешно |
404 | Ресурс не найден |
422 | Ошибка валидации |
429 | Превышен лимит запросов |
AI / LLM контуры
Эти endpoints предназначены для дешёвого machine-readable потребления без HTML-парсинга. Они возвращают canonical URL, citation guidance и provenance-поля.
/api/v1/ai/latest
JSONL discovery-feed для статей, ЦБД и press events.
| Параметр | Тип | Описание |
|---|---|---|
lang | string | ru, kk, en |
limit | int | 1..50 |
max_chars | int | 300..4000 |
include | string | articles, antifake, events |
curl 'https://ortcom.qdev.run/api/v1/ai/latest?lang=ru&include=articles,antifake&limit=3'/api/v1/ai/article/{source_id_or_slug}
Компактный JSON detail для одной статьи.
/api/v1/ai/article/{source_id_or_slug}/markdown
Markdown-версия статьи для ingestion-пайплайнов.
/api/v1/ai/antifake/{id_or_slug}
Компактный JSON detail для одной фактчекинг-записи.
/api/v1/ai/event/{id_or_slug}
Компактный JSON detail для пресс-мероприятия.
Статьи
/api/v1/articles
Список статей с фильтрами.
| Параметр | Тип | Описание |
|---|---|---|
lang | string | ru, kk, en |
category | string | Slug категории (novosti, region-news...) |
q | string | Поиск |
date_from | string | YYYY-MM-DD |
date_to | string | YYYY-MM-DD |
curl https://ortcom.qdev.run/api/v1/articles?lang=ru&category=novosti&limit=5/api/v1/articles/{id}
Отдельная статья с полным текстом.
Категории
/api/v1/categories
Список всех активных категорий.
АнтиФейк (ЦБД)
/api/v1/antifake
Список записей АнтиФейк-центра.
| Параметр | Тип | Описание |
|---|---|---|
verdict | string | fake, misleading, manipulated, unverified |
post_type | string | debunk, digest, advisory, analysis |
q | string | Поиск |
curl https://ortcom.qdev.run/api/v1/antifake?verdict=fake&limit=10/api/v1/antifake/stats
Общая статистика: по вердиктам, месячные тренды.
/api/v1/antifake/{id}
Отдельная запись с полным текстом.
Мероприятия
/api/v1/events
Список пресс-мероприятий.
| Параметр | Тип | Описание |
|---|---|---|
status | string | announced, live, completed, cancelled |
event_type | string | briefing, conference, soyle, roundtable |
Регионы
/api/v1/regions
Список регионов Казахстана.
/api/v1/regions/{slug}/articles
Статьи по конкретному региону.
Попробовать
Результат будет здесь