İçeriğe atla
TM
Geliştiriciler için

API Belgeleri

Üniversite, bölüm ve program verilerine salt-okunur JSON erişimi. Anahtar gerekmez; dakikada 60 istek sınırı vardır ve tüm uçlar yalnızca GET kabul eder.

API açık ve kullanılabilir — anahtar gerekmez, hemen deneyebilirsin.

Hızlı başlangıç

Temel adres https://tercihmerkezi.com/api/v1. Bir terminal aç, ilk isteğini at:

İstek curl 
curl "https://tercihmerkezi.com/api/v1/programlar?universite=bogazici-universitesi&limit=2"
Yanıt 200 · application/json 
{
  "ok": true,
  "data": {
    "total": 41,
    "limit": 2,
    "offset": 0,
    "items": [
      {
        "ad": "Bilgisayar Mühendisliği (İngilizce)",
        "universite": "Boğaziçi Üniversitesi",
        "puan_turu": "say",
        "son_veri": { "yil": 2026, "kontenjan": 80, "taban_puan": 526.75, "basari_sirasi": 4560 },
        "url": "https://tercihmerkezi.com/program/bogazici-universitesi-bilgisayar-muhendisligi-ingilizce"
      }
    ]
  }
}

Uçlar

Yedi uç, tek sürüm. Liste uçları limit ve offset ile sayfalanır.

Uç Açıklama Parametreler
GET /api/v1 Uç listesi ve sürüm bilgisi —
GET /api/v1/universiteler Üniversite listesi q, sehir, tur, limit, offset
GET /api/v1/universiteler/{slug} Üniversite ayrıntısı —
GET /api/v1/bolumler Bölüm listesi q, limit, offset
GET /api/v1/programlar Program listesi (son yıl metrikleriyle) q, universite, bolum, puan_turu, limit, offset
GET /api/v1/programlar/{slug} Program ayrıntısı ve tüm yılların metrikleri —
GET /api/v1/sehirler Üniversitesi olan iller —