KAP bildirimleri
GET /v1/news: bildirim listesi (cursor sayfalama); GET /v1/news/{id}: içerik blokları ve ekler.
Yetki: news:read
Kamuyu Aydınlatma Platformu (KAP) bildirimleri. Kimlik KAP'ın kendi bildirim numarasıdır (disclosureIndex); aynı numara KAP sayfasında da görünür. Anlık akış (SSE) ve giden webhook ayrı bir modül olarak planlıdır; bu sürümde yalnız okuma vardır.
GET /v1/news
En yeniden eskiye sıralı liste. Gövde listede yoktur, detay ucundan alınır.
Parametreler
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
symbols | string | hayır | Virgülle ayrılmış semboller, en fazla 50: THYAO,ASELS |
types | string | hayır | Bildirim sınıfı, virgülle: FR (finansal rapor), ODA (özel durum), CA, DG, DUY, FON |
q | string | hayır | Başlıkta arama; her kelime geçmeli, Türkçe karakter toleranslı (kar → Kâr) |
from | string | hayır | YYYY-MM-DD (İstanbul günü başı) ya da ISO zaman damgası |
to | string | hayır | YYYY-MM-DD (İstanbul günü sonu) ya da ISO zaman damgası |
cursor | number | hayır | Önceki yanıttaki meta.nextCursor; ondan küçük numaralı bildirimler döner |
limit | number | hayır | 1 ile 100 arası, varsayılan 20 |
Örnek
curl "https://api.istfin.com/v1/news?symbols=THYAO&types=ODA,FR&limit=20" \ -H "Authorization: Bearer $ISTFIN_API_KEY"Yanıt
{
"data": [
{
"id": 1412345,
"type": "ODA",
"symbols": ["THYAO"],
"title": "Yeni Uçak Siparişi Hakkında",
"summary": "Şirket 30 adet dar gövdeli uçak siparişi verdi.",
"isUpdate": false,
"isCorrection": false,
"publishedAt": "2026-10-06T07:32:11.000Z",
"url": "https://www.kap.org.tr/tr/Bildirim/1412345"
}
],
"meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j", "nextCursor": "1412345", "hasMore": true }
}Sonraki sayfa için cursor=1412345 gönderin; hasMore false olana kadar devam edin.
GET /v1/news/{id}
Tek bildirimin tam içeriği. Bulunamazsa 404 NOT_FOUND.
Örnek
curl "https://api.istfin.com/v1/news/1412345" \ -H "Authorization: Bearer $ISTFIN_API_KEY"Yanıt
Liste alanlarına ek olarak:
| Alan | Tip | Açıklama |
|---|---|---|
funds | string[] | İlgili fon kodları |
sectors | string[] | İlgili sektörler |
content | { type, label, value }[] | İçerik blokları: field (etiket/değer), section, text, html |
attachments | { fileName, url }[] | Ekler |
updatedAt | string | null | Son güncelleme (UTC) |