▪ YokAPI

YokAtlas için resmi olmayan API
Unoffical API for YokAtlas

İletişim - Contact Me

Telegram: izcipy
Mail: ramazan.izcir@gmail.com

🆕 Net Sihirbazı desteği eklendi! Bölüm bazlı tüm bölümlere son giren kişilerin netlerine ve obpsine ulaşın.

📦 Kurulum

pip install YokAPI

📄 Örnek Kullanımlar

from YokAPI import Lisans, Onlisans
import asyncio

async def main():
    # Bölüm arama ve ÖSYM program kodu bulma için aşağıdaki CSV bölümüne bakınız.
    async with Lisans(program_id=108210665, year=2024) as lisans:

        r = await lisans.kontenjan() # -> Kontenjan
        """ ---> Kontenjan(
                osym_kod=108210665,
                year=2024,
                kont_gte=85,
                genel_kont=85,
                yer_oran=100.0,
                kesn_kayt=88,
                kayt_yptrmyn=0,
                tubitak=None,
                engelli=None,
                okl_bir_kont=3,
                okl_bir_yer=3,
                t_kont=88,
                t_yer=88,
                ek_yer=0
            )
        """

        print(r.osym_kod) # -> 108210665
        print(r.year) # -> 2024
        print(r.genel_kont) # -> 85

        r_iller = await lisans.iller() # -> Iller
        """ ---> Iller(
                osym_kod=108210665,
                year=2024,
                sehirler=[Il(
                    isim="Toplam",
                    sayi=88,
                    oran=100.0
                ),
                Il(
                    isim="Samsun",
                    sayi=16,
                    orn=18.2
                ),
                ]
            )
        """
        print(r_iller.sehirler[1].isim) # -> Samsun
        print(r_iller.sehirler[1].sayi) # -> 16
        print(r_iller.sehirler[1].orn) # -> 18.2
        lise_dict = r_iller.model_dump()  # pydantic.BaseModel methods
        print(lise_dict) # -> {'osym_kod': 108210665, 'year': 2024, 'sehirler': [{'isim': 'Toplam', 'sayi': 88, 'orn': 100.0}, {'isim': 'Samsun', 'sayi': 16, 'orn': 18.2}, ...]

if __name__ == "__main__":
    asyncio.run(main())

With Olmadan Kullanım

from YokAPI import Lisans, Onlisans
import asyncio

async def main():
    # Bölüm arama ve ÖSYM program kodu bulma için aşağıdaki CSV bölümüne bakınız.

    lisans_1 = Lisans(program_id=108210665, year=2024)
    r = await lisans_1.kontenjan() # -> Kontenjan
    print(r.tubitak) # -> None # 0

    await lisans_1.close() # oluşan sessionu kendimiz kapatmalıyız. with bloğu kendi kapatır.


if __name__ == "__main__":
    asyncio.run(main())

Ayrı Session Kullanma

Program session parametresi vermezseniz kendi sessionunu oluşturur. Kendi sessionuzu vermek isterseniz aşağıdaki kodu inceleyin.

from YokAPI import Lisans, Onlisans
import asyncio
import aiohttp
# import certifi
# import ssl

async def main():
    # ssl_context = ssl.create_default_context(cafile=certifi.where())
    session_ = aiohttp.ClientSession(
        connector=aiohttp.TCPConnector(ssl=False),  # İsterseniz ssl_context kullanarak doğrulamayı açabilirsiniz.
        headers={
            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36"
        }        
    )
    onlisans_1 = Onlisans(program_id=108250346, year=2024, session=session_)
    r = await onlisans_1.genel_blg() # -> GenelBilgilerOnlisans
    print(r.bos_kontenjan) # -> None # 0
    await session_.close()

if __name__ == "__main__":
    asyncio.run(main())

🔎 Bölüm OSYM Kodu CSV’si (data/universities_departments.csv)

YokAPI kullanıcılarının bölümlerin ÖSYM program kodunu (osym_kod / program_code) hızlıca bulup veri çekebilmesi için, ÖSYM’nin yayımladığı kaynaklardan derlenmiş toplu ve temizlenmiş bir CSV dosyası eklenmiştir: data/universities_departments.csv.

CSV sütunları:
- program_code (ÖSYM kodu)
- department_name (Bölüm adı)
- university_name (Üniversite adı)
- faculty_name (Fakülte adı)
- is_undergraduate (Lisans=True, Önlisans=False)
- years (ör. 2022,2023,2024)
- tags (İngilizce, KKTC, vb.)
- score_type (ör. SAY/SÖZ/EA/TYT)
- scholarship_type (ör. Ücretsiz/Burslu/%50 İndirimli)

Kısa bir örnek satırlar:

program_code	department_name	university_name	faculty_name	is_undergraduate	years	tags	score_type	scholarship_type
103390230	Abaza Dili ve Edebiyatı	DÜZCE ÜNİVERSİTESİ	Fen-Edebiyat Fakültesi	True	2024		SÖZ	Ücretsiz
108690161	Acil Durum ve Afet Yönetimi	PAMUKKALE ÜNİVERSİTESİ	Serinhisar Meslek Yüksekokulu	False	2022,2023,2024		TYT	Ücretsiz

Notlar ve öneriler:

Şu an YÖK Atlas’ta mevcut yıllar: 2022, 2023, 2024. Bir bölüm bazı yıllarda bulunmayabilir; istek atmadan önce CSV’deki years sütununu kontrol edip uygun yılı seçin.
Büyük boyutlu JSON’u repo’ya eklemedim; isterseniz data/data_csv_to_json.py ile CSV’yi üniversiteye göre gruplanmış JSON’a dönüştürüp kullanabilirsiniz.
YokAPI scraper ile üretilmiş daha detaylı ve temizlenmiş bir veri seti için: https://github.com/izcir/turkish-university-admissions-dataset

Hızlı kullanım örnekleri

CSV’den osym_kod bulup YokAPI ile veri çekme (Lisans örneği):

import pandas as pd
from YokAPI import Lisans
import asyncio

async def run():
    df = pd.read_csv("data/universities_departments.csv")

    row = df[(df["university_name"] == "ONDOKUZ MAYIS ÜNİVERSİTESİ") &
             (df["department_name"] == "Bilgisayar Mühendisliği") &
             (df["is_undergraduate"] == True)].iloc[0]

    program_id = int(row["program_code"]) # 108210665
    years = str(row.get("years")).split(",") # -> ['2022', '2023', '2024']
    year = years[-1] # -> 2024    

    async with Lisans(program_id=program_id, year=year) as lisans:
        genel = await lisans.genel_blg()
        print(genel.toplam_kontenjan, genel.yer_012_son_sira)

asyncio.run(run())

Önlisans bölümleri için benzer şekilde is_undergraduate == False filtreleyip Onlisans sınıfını kullanın.

📌 `Lisans` Fonksiyonlar ve Modeller

Modeller pydantic.BaseModel sınıfındandır. BaseModel docs

🔹 Temel Bilgiler

cinsiyet() → Cinsiyet
kontenjan() → Kontenjan
ogr_durum() → OgrenimDurumu
genel_blg() → GenelBilgiler

📊 YKS Verileri

yks_net() → YksNet
yks_puan() → YksPuan
yks_sira() → YksSira
son_profil() → SonProfil

🏫 Lise Bilgileri

lise_alan() → LiseAlan
liseler() → Liseler
lise_grup_tip() → LiseTip
okul_birinci() → OkulBirinciKontenjan

🎓 Üniversite Tercih Verileri

tercih_il() → TercihIl
tercih_fark() → TercihFark
tercih_program() → TercihProgram
tercih_uni() → TercihUni
tercih_uni_tur() → TercihUniTur
tercih_istatistik() → TercihIstatistik
ort_tercih() → OrtTercih
taban_puan() → TabanPuan
tercih_genel() → TercihGenel

🔄 Öğrenci Hareketleri

mezun_yil() → MezunYil
degisim_ogr() → DegisimOgrenci
mezun_ogr() → MezunOgrenci
kayitli_ogr() → KayitliOgrenci
yatay_gecis() → YatayGecis

🏛 Akademik Bilgiler

ogretim_uyesi() → OgretimUyesi
yerlesme_kosul() → YerlesmeKosul

🌍 Coğrafi Bilgiler

cograf_bolg() → CografiBolgeler
iller() → İller

📌 `Önlisans` Fonksiyonlar ve Modeller

Modeller pydantic.BaseModel sınıfındandır. BaseModel docs
Lisanstan farklı Modeller: TercihFarkOnlisans, TabanPuanOnlisans, GenelBilgilerOnlisans
Önlisansta bulunmayan YKS verileri: yks_puan(), yks_sira()

🔹 Temel Bilgiler

cinsiyet() → Cinsiyet
kontenjan() → Kontenjan
ogr_durum() → OgrenimDurumu
genel_blg() → GenelBilgilerOnlisans

📊 YKS Verileri

yks_net() → YksNet
son_profil() → SonProfil

🏫 Lise Bilgileri

lise_alan() → LiseAlan
liseler() → Liseler
lise_grup_tip() → LiseTip
okul_birinci() → OkulBirinci

🎓 Üniversite Tercih Verileri

tercih_il() → TercihIl
tercih_fark() → TercihFarkOnlisans
tercih_program() → TercihProgram
tercih_uni() → TercihUni
tercih_uni_tur() → TercihUniTur
tercih_istatistik() → TercihIstatistik
ort_tercih() → OrtTercih
taban_puan() → TabanPuanOnlisans
tercih_genel() → TercihGenel

🔄 Öğrenci Hareketleri

mezun_yil() → MezunYil
degisim_ogr() → DegisimOgrenci
mezun_ogr() → MezunOgrenci
kayitli_ogr() → KayitliOgrenci
yatay_gecis() → YatayGecis

🏛 Akademik Bilgiler

ogretim_uyesi() → OgretimUyesi
yerlesme_kosul() → YerlesmeKosul

🌍 Coğrafi Bilgiler

cograf_bolg() → CografiBolgeler
iller() → İller

📌 `NetSihirbaziLisans` ve `NetSihirbaziOnlisans` Kullanımı

Net Sihirbazı, belirli bir bölüm için tüm üniversitelerdeki yerleşen son kişinin net ortalamalarını getirir.

Örnek Kullanım

from YokAPI import NetSihirbaziLisans, NetSihirbaziOnlisans
import asyncio

async def main():
    # Lisans için (bolum_id: data/bolumler_lisans.csv dosyasından alınır)
    async with NetSihirbaziLisans(bolum_id=11685) as net_lisans:  # 11685 = Abaza Dili ve Edebiyatı
        data = await net_lisans.net_sihirbazi()
        print(data.model_dump())
    
    # Önlisans için (bolum_id: data/bolumler_onlisans.csv dosyasından alınır)
    async with NetSihirbaziOnlisans(bolum_id=32020) as net_onlisans:  # 32020 = Bilgisayar Programcılığı
        data = await net_onlisans.net_sihirbazi()
        print(data.model_dump())

asyncio.run(main())

Örnek Çıktı (Lisans - Abaza Dili ve Edebiyatı)

{
  "bolum_id": 11685,
  "bolumler": [
    {
      "osym_kod": 103390230,
      "year": 2025,
      "uni": "DÜZCE ÜNİVERSİTESİ (4 Yıllık)",
      "katsayi": 0.12,
      "obp": 308.126,
      "puan": 213.28355,
      "bolum_yerlesen": "21",
      "dersler": {
        "TYT Türkçe": 8.0,
        "TYT Sosyal": 7.0,
        "TYT Mat": -1.75,
        "TYT Fen": 2.0,
        "AYT TDE": 0.5,
        "AYT Tar1": 3.25,
        "AYT Coğ1": -0.5,
        "AYT Tar2": 2.25,
        "AYT Coğ2": 5.0,
        "AYT Fel": -0.25,
        "AYT Din": 0.75
      }
    },
    {
      "osym_kod": 103390231,
      "year": 2025,
      "uni": "DÜZCE ÜNİVERSİTESİ (İÖ) (4 Yıllık)",
      "katsayi": 0.12,
      "obp": 295.432,
      "puan": 198.54321,
      "bolum_yerlesen": "15",
      "dersler": {
        "TYT Türkçe": 6.5,
        "TYT Sosyal": 5.0,
        "TYT Mat": 1.25,
        "TYT Fen": 3.0,
        "AYT TDE": 1.0,
        "AYT Tar1": 2.5,
        "AYT Coğ1": 0.75,
        "AYT Tar2": 1.5,
        "AYT Coğ2": 3.25,
        "AYT Fel": 0.5,
        "AYT Din": 1.25
      }
    }
  ]
}

Notlar

bolum_id değerleri data/bolumler_lisans.csv ve data/bolumler_onlisans.csv dosyalarından alınabilir.
dersler alanı dinamik olarak oluşturulur ve bölümün puan türüne göre farklı dersler içerebilir (SAY/SÖZ/EA/TYT).
Her üniversitedeki yerleşen son kişinin net ortalamaları döndürülür.

📌 Modeller

Bu bölümde, veri modelleri ve içerikleri açıklanmaktadır.

`GenelBilgiler`

Alan	Tür	Bilgi
`osym_kod`	`int`	ÖSYM program kodu
`year`	`int`	Yıl
`bolum_ismi`	`str`	Bölüm adı
`program_kod`	`int`	Program kodu
`uni_tur`	`str`	Üniversite türü
`uni`	`str`	Üniversite adı
`fakulte`	`str`	Fakülte adı
`puan_tur`	`str`	Puan türü
`burs_tur`	`str`	Burs durumu
`genel_kontenjan`	`int`	Genel kontenjan
`ob_kontenjan`	`int`	OBP kontenjanı
`toplam_kontenjan`	`int`	Toplam kontenjan
`genel_yerlesen`	`int`	Genel yerleşen
`ob_yerlesen`	`int`	OBP yerleşen
`toplam_yerlesen`	`int`	Toplam yerleşen
`bos_kontenjan`	`int`	Boş kontenjan
`ilk_yer_oran`	`float`	İlk yerleşme oranı
`kayit_yaptirmayan`	`int`	Kayıt yaptırmayan
`ek_yerlesen`	`int`	Ek yerleşen
`yer_012_son_puan`	`float`	0.12 katsayı puanı
`yer_018_son_puan`	`float`	0.18 katsayı puanı
`yer_012_son_sira`	`int`	0.12 katsayı sıra
`yer_018_son_sira`	`int`	0.18 katsayı sıra
`tavan_puan`	`float`	En yüksek puan
`tavan_basari_sira`	`int`	En iyi sıra
`obp_kirilan`	`int`	OBP kırılan
`ort_obp`	`float`	Ortalama OBP
`ort_diploma`	`float`	Ortalama diploma

`GenelBilgilerOnlisans`

Alan	Tür	Bilgi
`osym_kod`	`int`	ÖSYM program kodu
`year`	`int`	Yıl
`bolum_ismi`	`str`	Bölüm adı
`program_kod`	`int`	Program kodu
`uni_tur`	`str`	Üniversite türü
`uni`	`str`	Üniversite adı
`fakulte`	`str`	Fakülte adı
`puan_tur`	`str`	Puan türü
`burs_tur`	`str`	Burs durumu
`genel_kontenjan`	`int`	Genel kontenjan
`ob_kontenjan`	`int`	OBP kontenjanı
`toplam_kontenjan`	`int`	Toplam kontenjan
`genel_yerlesen`	`int`	Genel yerleşen
`ob_yerlesen`	`int`	OBP yerleşen
`toplam_yerlesen`	`int`	Toplam yerleşen
`bos_kontenjan`	`int`	Boş kontenjan
`ilk_yer_oran`	`float`	İlk yerleşme oranı
`kayit_yaptirmayan`	`int`	Kayıt yaptırmayan
`ek_yerlesen`	`int`	Ek yerleşen
`yer_012_son_puan`	`float`	0.12 katsayı puanı
`yer_018_son_puan`	`float`	0.18 katsayı puanı
`yer_012_son_sira`	`int`	0.12 katsayı sıra
`yer_018_son_sira`	`int`	0.18 katsayı sıra
`tavan_2024_puan`	`float`	En yüksek puan (2024)
`tavan_2024_sira`	`int`	En iyi sıra (2024)
`ort_obp_2024`	`float`	Ortalama OBP (2024)
`ort_dn_2024`	`float`	Ortalama diploma notu (2024)

`Kontenjan`

Alan	Tür	Bilgi
`osym_kod`	`int`	ÖSYM program kodu
`year`	`int`	Yıl
`kont_gte`	`int`	Kontenjan Genel, Tübitak, Engelli toplam
`genel_kont`	`int`	Genel kontenjan
`yer_oran`	`float`	Yerleşme oranı
`kesn_kayt`	`int`	Kesin kayıt yaptıran
`kayt_yptrmyn`	`int`	Kayıt yaptırmayan
`tubitak`	`int`	TÜBİTAK kontenjanı
`engelli`	`int`	Engelli kontenjanı
`okl_bir_kont`	`int`	Okul birincisi kontenjanı
`okl_bir_yer`	`int`	Okul birincisi yerleşen
`t_kont`	`int`	Toplam kontenjan
`t_yer`	`int`	Toplam yerleşen
`ek_yer`	`int`	Ek yerleşen

...existing code...

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
YokAPI		YokAPI
data		data
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
requirements.txt		requirements.txt
setup.py		setup.py

License

izcir/YokAPI

Folders and files

Latest commit

History

Repository files navigation

▪ YokAPI

İletişim - Contact Me

🆕 Net Sihirbazı desteği eklendi! Bölüm bazlı tüm bölümlere son giren kişilerin netlerine ve obpsine ulaşın.

📦 Kurulum

📄 Örnek Kullanımlar

With Olmadan Kullanım

Ayrı Session Kullanma

🔎 Bölüm OSYM Kodu CSV’si (data/universities_departments.csv)

Hızlı kullanım örnekleri

📌 Lisans Fonksiyonlar ve Modeller

🔹 Temel Bilgiler

📊 YKS Verileri

🏫 Lise Bilgileri

🎓 Üniversite Tercih Verileri

🔄 Öğrenci Hareketleri

🏛 Akademik Bilgiler

🌍 Coğrafi Bilgiler

📌 Önlisans Fonksiyonlar ve Modeller

🔹 Temel Bilgiler

📊 YKS Verileri

🏫 Lise Bilgileri

🎓 Üniversite Tercih Verileri

🔄 Öğrenci Hareketleri

🏛 Akademik Bilgiler

🌍 Coğrafi Bilgiler

📌 NetSihirbaziLisans ve NetSihirbaziOnlisans Kullanımı

Örnek Kullanım

Örnek Çıktı (Lisans - Abaza Dili ve Edebiyatı)

Notlar

📌 Modeller

GenelBilgiler

GenelBilgilerOnlisans

Kontenjan

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 7

Packages 0

Uh oh!

Languages

📌 `Lisans` Fonksiyonlar ve Modeller

📌 `Önlisans` Fonksiyonlar ve Modeller

📌 `NetSihirbaziLisans` ve `NetSihirbaziOnlisans` Kullanımı

`GenelBilgiler`

`GenelBilgilerOnlisans`

`Kontenjan`

Packages