API Documentation
Public API for accessing ortcom.kz data. News, AntiFake, events and regions.
https://ortcom.qdev.run/api/v1/
Overview
The ortcom.kz Public API provides programmatic access to news, AntiFake data, press events and regional information. It follows RESTful principles and returns responses in JSON format.
Authentication
The current API works without authentication. All public data is freely available. Expanded access via API keys may be added later.
Pagination
All list endpoints support pagination:
/api/v1/articles?page=2&limit=10
{
"api_version": "1.0.0",
"meta": {
"total": 1250,
"page": 2,
"per_page": 10,
"pages": 125
},
"data": [...]
}| Parameter | Type | Description |
|---|---|---|
page | int | Page number (starting from 1) |
limit | int | Items per page (max. 100) |
Errors
| Code | Description |
|---|---|
200 | Success |
404 | Resource not found |
422 | Validation error |
429 | Rate limit exceeded |
AI / LLM surfaces
These endpoints are designed for low-cost machine consumption without HTML parsing. They return canonical URLs, citation guidance and provenance fields.
/api/v1/ai/latest
JSONL discovery feed for articles, fact-checks and press events.
| Parameter | Type | Description |
|---|---|---|
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}
Compact JSON detail for a single article.
/api/v1/ai/article/{source_id_or_slug}/markdown
Markdown version of an article for ingestion pipelines.
/api/v1/ai/antifake/{id_or_slug}
Compact JSON detail for one fact-check record.
/api/v1/ai/event/{id_or_slug}
Compact JSON detail for a press event.
Articles
/api/v1/articles
Article list with filters.
| Parameter | Type | Description |
|---|---|---|
lang | string | ru, kk, en |
category | string | Category slug (novosti, region-news...) |
q | string | Search query |
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}
Single article with full text.
Categories
/api/v1/categories
List of all active categories.
AntiFake (CCD)
/api/v1/antifake
List of AntiFake Center records.
| Parameter | Type | Description |
|---|---|---|
verdict | string | fake, misleading, manipulated, unverified |
post_type | string | debunk, digest, advisory, analysis |
q | string | Search query |
curl https://ortcom.qdev.run/api/v1/antifake?verdict=fake&limit=10/api/v1/antifake/stats
General statistics by verdict and monthly trends.
/api/v1/antifake/{id}
Single record with full text.
Events
/api/v1/events
List of press events.
| Parameter | Type | Description |
|---|---|---|
status | string | announced, live, completed, cancelled |
event_type | string | briefing, conference, soyle, roundtable |
Regions
/api/v1/regions
List of Kazakhstan regions.
/api/v1/regions/{slug}/articles
Articles for a specific region.
Try it
The result will appear here