# DMM LLM API

**T.C. Cumhurbaşkanlığı İletişim Başkanlığı – Dezenformasyonla Mücadele Merkezi**
*Presidency of the Republic of Türkiye, Directorate of Communications – Centre for Combating Disinformation*

> ⚙️ Bu API, büyük dil modellerini dezenformasyona karşı eğitmek için tasarlanmıştır.
> ⚙️ This API is designed to train large language models against disinformation.

DMM dezenformasyon bültenlerinin vektörize edilmiş hali — RAG, fine-tuning ve dezenformasyon tespit sistemleri için.
Vectorised repository of DMM disinformation bulletins — for RAG pipelines, fine-tuning and detection systems.

Tüm **okuma** işlemleri kimlik doğrulama gerektirmez. All **read** operations require no authentication.

LLM tanım dosyası / LLM manifest: [https://llm.iletisim.gov.tr/llms.txt](https://llm.iletisim.gov.tr/llms.txt)
Tam dokümantasyon / Full documentation: [https://llm.iletisim.gov.tr/llms-full.txt](https://llm.iletisim.gov.tr/llms-full.txt)

---

## Hızlı Başlangıç / Quick Start

### 1. Tüm veriyi al / Fetch all data

```
GET https://llm.iletisim.gov.tr/api/v1/bulletins
GET https://llm.iletisim.gov.tr/api/v1/bulletins?page=1&page_size=100
GET https://llm.iletisim.gov.tr/api/v1/bulletins?bulletin_number=63
```

| Parametre | Varsayılan / Default | Açıklama / Description |
|-----------|----------------------|------------------------|
| `page` | 1 | Sayfa numarası / Page number |
| `page_size` | 20 (maks/max: 100) | Sayfa başı kayıt / Records per page |
| `bulletin_number` | — | Belirli bülten / Filter by bulletin number |

---

### 2. Konuya göre ara / Search by topic

```
GET https://llm.iletisim.gov.tr/api/v1/search?q=terör
GET https://llm.iletisim.gov.tr/api/v1/search?q=togg&top_k=20
GET https://llm.iletisim.gov.tr/api/v1/search?q=deprem+yardımları&top_k=5
GET https://llm.iletisim.gov.tr/api/v1/search?q=disinformation+elections&top_k=10
```

| Parametre | Varsayılan / Default | Açıklama / Description |
|-----------|----------------------|------------------------|
| `q` | — | Arama metni / Query text (Türkçe/English) |
| `top_k` | 10 (maks/max: 50) | Sonuç sayısı / Number of results |
| `include_vectors` | false | Embedding vektörleri / Include embedding vectors |

---

### 3. Tekil kayıt / Single record

```
GET https://llm.iletisim.gov.tr/api/v1/bulletins/dmm-bulletin-63-claim-001
```

---

## Veri Yapısı / Data Schema

Her kayıt [Schema.org ClaimReview](https://schema.org/ClaimReview) standardındadır.
Each record follows the [Schema.org ClaimReview](https://schema.org/ClaimReview) standard.

| Alan / Field | Açıklama / Description |
|---|---|
| `id` | `dmm-bulletin-{N}-claim-{idx}` |
| `claimReviewed` | İddia edilen dezenformasyon / Alleged disinformation text |
| `factCheckResult` | Doğrulanmış gerçek / Verified fact |
| `reviewRating.ratingValue` | 1=Yanlış/False … 5=Doğru/True |
| `bulletinNumber` | Kaynak bülten no / Source bulletin number |
| `datePublished` | Yayım tarihi / Publication date (ISO 8601) |
| `embeddings` | `claim_vector` + `fact_check_vector` |

Şema detayı / Schema detail: [https://llm.iletisim.gov.tr/api/v1/bulletins/schema](https://llm.iletisim.gov.tr/api/v1/bulletins/schema)

---

## Kaynaklar / Resources

| | TR | EN |
|---|---|---|
| API Tanımı | [llms.txt](https://llm.iletisim.gov.tr/llms.txt) | LLM inference-time summary |
| Tam Dokümantasyon | [llms-full.txt](https://llm.iletisim.gov.tr/llms-full.txt) | Full API documentation |
| Spesifikasyon | [openapi.json](https://llm.iletisim.gov.tr/openapi.json) | OpenAPI 3.1 LLM-readable spec |
| Swagger UI | [/docs](https://llm.iletisim.gov.tr/docs) | Interactive explorer |
| Sistem Durumu | [/status](https://llm.iletisim.gov.tr/status) | Live metrics (JSON) |
| AI Politikası | [/ai-policy.txt](https://llm.iletisim.gov.tr/ai-policy.txt) | AI Usage & Training Policy |
| Veri Kaynağı | [DMM Bültenleri](https://www.iletisim.gov.tr/turkce/dezenformasyon-bulteni) | Tüm DMM bültenleri / All DMM bulletins |