İçeriğe geç

KAP API: KAP bildirimlerini JSON olarak çekin

Kamuyu Aydınlatma Platformu bildirimlerini kazıma kodu yazmadan alın: özel durum açıklamaları, finansal raporlar, temettü ve genel kurul bildirimleri. Sembol, tür ve tarihe göre filtreleyin; tam içerik ve eklerle.

Hemen başlaDokümantasyon

Tek istekle bildirim listesi

En yeniden eskiye sıralı, cursor ile sayfalanır.

curl "https://api.istfin.com/v1/news?symbols=THYAO,ASELS&types=ODA,FR&limit=20" \
  -H "Authorization: Bearer istfin_live_..."
{
  "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.",
      "publishedAt": "2026-10-06T07:32:11.000Z",
      "url": "https://www.kap.org.tr/tr/Bildirim/1412345"
    }
  ],
  "meta": { "nextCursor": "1412345", "hasMore": true }
}

Neden scraper yerine KAP API

Scraper yok

KAP sayfaları değişince kırılan kazıma kodu, IP engelleri ve oturum sorunları yok. Tek bir REST ucu, sabit bir JSON şeması.

Filtreleyerek çekin

Sembol (virgülle birden fazla), bildirim türü, tarih aralığı ve başlıkta Türkçe karakter toleranslı arama. Sayfalama cursor ile.

Tam içerik ve ekler

Detay ucu bildirimin içerik bloklarını (alan, bölüm, metin), ilgili sektörleri ve ek dosya bağlantılarını döner. Kimlik KAP’ın kendi bildirim numarasıdır.

Fiyat ve bilançoyla aynı yerde

Aynı anahtarla hisse fiyatı (15 dk gecikmeli), OHLC barlar, finansal tablolar ve oranlar. Bildirimi fiyat hareketiyle tek kodda eşleştirin.

Bildirim türleri

types parametresine virgülle verilir.

KodAnlamı
ODAÖzel durum açıklaması
FRFinansal rapor (bilanço, gelir tablosu, faaliyet raporu)
CAKurumsal işlem bildirimleri (temettü, sermaye artırımı, genel kurul vb.)
DGDiğer bildirimler
DUYDüzenleyici kurum duyuruları
FONFon bildirimleri

Python ile KAP bildirimleri

requests ile birkaç satır.

import requests

r = requests.get(
    "https://api.istfin.com/v1/news",
    params={"symbols": "THYAO", "types": "ODA", "from": "2026-10-01"},
    headers={"Authorization": "Bearer istfin_live_..."},
)
for item in r.json()["data"]:
    print(item["publishedAt"], item["title"])

Tüm parametreler ve detay ucu: KAP bildirimleri dokümantasyonu. Yapay zeka asistanıyla kullanmak için BIST MCP.

Sık sorulanlar

KAP’ın resmi bir API’si var mı?

KAP’ın kurumlara yönelik veri hizmetleri vardır, ancak bireysel kullanıcının kod yazarak bildirim çekebileceği açık, belgelenmiş bir REST API sunulmaz. Bu yüzden çoğu proje KAP sayfalarını kazır ve sayfa yapısı değişince bozulur. istfin KAP bildirimlerini düzenli bir JSON şemasıyla sunar.

Hangi bildirimler var?

Borsa İstanbul şirketlerinin özel durum açıklamaları, finansal raporları, genel kurul ve temettü gibi şirket bildirimleri, duyurular ve fon bildirimleri. Her kayıt KAP bildirim numarası ve KAP bağlantısıyla gelir.

Python ile KAP bildirimleri nasıl çekilir?

requests ile GET /v1/news ucuna Authorization: Bearer başlığıyla istek atın; symbols, types ve from parametreleriyle filtreleyin. Yanıt data dizisi ve sonraki sayfa için meta.nextCursor döner. Örnek kod bu sayfada.

Claude ya da ChatGPT KAP bildirimlerini okuyabilir mi?

Evet. istfin MCP sunucusunu bağladığınızda asistan search_news ve get_news araçlarıyla bildirimleri arar ve okur. “ASELS’in son özel durum açıklamalarını özetle” gibi sorabilirsiniz. KAP metinleri asistana güvenilmeyen içerik olarak işaretlenir.

KAP API ücretli mi?

KAP bildirimleri istfin API aboneliğine dahildir; ayrı bir ücret yoktur. Aynı abonelikte fiyat, OHLC bar, finansal tablo ve MCP erişimi de gelir. Güncel fiyat fiyatlandırma sayfasında.

Bildirimler ne zaman gelir?

Bildirimler KAP’ta yayımlandıktan sonra sisteme alınır ve publishedAt alanı KAP’taki yayım zamanını (UTC) taşır. Anlık akış (SSE) ve webhook ayrı bir modül olarak planlıdır; bu sürümde liste ve detay okuması vardır.

KAP bildirimlerini kodunuza bağlayın

Abone olun, anahtarınızı üretin, ilk isteği atın. Bildirimler, fiyatlar ve finansal tablolar aynı abonelikte.

Hemen başlaDokümantasyon