▪ YokAPI
- YokAtlas için resmi olmayan API
- Unoffical API for YokAtlas
İletişim - Contact Me
📦 Kurulum
pip install YokAPI
📄 Örnek Kullanımlar
from YokAPI import Lisans, Onlisans
import asyncio
async def main():
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
import asyncio
async def main():
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=ssl_context), # ssl=False
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())
✔ Yapılacaklar
📌 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
📌 Modeller
- Bu bölümde, veri modelleri ve içerikleri açıklanmaktadır.
| 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 |
| 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) |
| 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 |
| Alan |
Tür |
Bilgi |
sayi |
int |
Sayısal değer |
orn |
float |
Oran değeri |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
erkek |
ModelDetay |
Erkek aday verileri |
kadin |
ModelDetay |
Kadın aday verileri |
| Alan |
Tür |
Bilgi |
sayi |
int |
Toplam sayısal değer |
orn |
float |
Oran değeri |
erkek |
int |
Erkek sayısı |
kadin |
int |
Kadın sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
bolge |
Bolgeler |
Coğrafi bölge verileri |
sehir |
SehirDurum |
Şehir bazlı veriler |
| Alan |
Tür |
Bilgi |
isim |
str |
Şehir adı |
sayi |
int |
Sayısal değer |
orn |
float |
Oran değeri |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
sehirler |
list[Il] |
Şehir bazlı detaylar |
| Alan |
Tür |
Bilgi |
yil |
str |
Mezuniyet yılı |
sayi |
int |
Sayısal değer |
orn |
float |
Oran değeri |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
yillar |
list[YilModelDetay] |
Mezuniyet yılları |
| Alan |
Tür |
Bilgi |
alan |
str |
Lise alan adı |
sayi |
int |
Sayısal değer |
orn |
float |
Oran değeri |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
alanlar |
list[LiseAlanModelDetay] |
Lise alan detayları |
| Alan |
Tür |
Bilgi |
isim |
str |
Lise ismi |
toplam |
int |
Toplam öğrenci sayısı |
yeni_mezun |
int |
Yeni mezun öğrenci sayısı |
eski_mezun |
float |
Eski mezunların oranı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
liseler |
list[LiseModelDetay] |
Lise bazlı detaylar |
| Alan |
Tür |
Bilgi |
kont_turu |
str |
Kontenjan türü |
isim |
str |
Lise ismi |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
toplam |
int |
Toplam kontenjan |
genel |
int |
Genel kontenjan |
okul_bir |
int |
Okul birincisi kontenjanı |
sehit_gazi |
int |
Şehit/gazi yakını kontenjanı |
depremzede |
float |
Depremzede kontenjanı |
kadin_34yas |
int |
34 yaş üstü kadın kontenjanı |
liseler |
list[LiseYerlesme] |
Lise yerleşme detayları |
PuanModelDetay
| Alan |
Tür |
Bilgi |
kont_turu |
str |
Kontenjan türü |
kont |
int |
Kontenjan sayısı |
yerlesen |
int |
Yerleşen öğrenci sayısı |
puan |
float |
Puan değeri |
SiraModelDetay
| Alan |
Tür |
Bilgi |
kont_turu |
str |
Kontenjan türü |
kont |
int |
Kontenjan sayısı |
yerlesen |
int |
Yerleşen öğrenci sayısı |
sira_012 |
int |
0.12 katsayılı yerleşen sıra |
sira_012_006 |
int |
0.18 katsayılı yerleşen sıra |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
puanlar |
list[PuanModelDetay] |
Puan detayları |
siralar |
list[SiraModelDetay] |
Başarı sıraları |
PuanOnlisansModelDetay
| Alan |
Tür |
Bilgi |
kont_turu |
str |
Kontenjan türü |
kont |
int |
Kontenjan sayısı |
yerlesen |
int |
Yerleşen öğrenci sayısı |
puan_012 |
float |
0.12 katsayılı puan |
puan_012_006 |
float |
0.18 katsayılı puan |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
ogrnm_durumu |
str |
Öğrenim durumu |
mezun_yil |
int |
Mezuniyet yılı |
lise_alan |
str |
Lise alanı |
puan |
float |
Puan |
sira |
int |
Sıralama |
katsayi |
float |
Katsayı |
obp |
float |
OBP puanı |
dn |
float |
Diploma notu |
cinsiyet |
str |
Cinsiyet |
il |
str |
İl |
| Alan |
Tür |
Bilgi |
ders |
str |
Ders adı |
net_012 |
float |
0.12 katsayılı net |
net_012_006 |
float |
0.18 katsayılı net |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM program kodu |
year |
int |
Yıl |
yerlesen_012 |
float |
0.12 katsayılı yerleşen oranı |
yerlesen_012_006 |
float |
0.18 katsayılı yerleşen oranı |
ort_obp_012 |
float |
0.12 katsayılı ortalama OBP |
ort_obp_012_006 |
float |
0.18 katsayılı ortalama OBP |
dersler |
list[DersModelDetay] |
Derslerin detayları |
| Alan |
Tür |
Bilgi |
yer_012 |
int |
0.12 katsayılı yerleşen sayısı |
yer_012_006 |
int |
0.18 katsayılı yerleşen sayısı |
obp_012 |
float |
0.12 katsayılı OBP |
obp_012_006 |
float |
0.18 katsayılı OBP |
tyt_012 |
float |
0.12 katsayılı TYT puanı |
tyt_012_006 |
float |
0.18 katsayılı TYT puanı |
| Alan |
Tür |
Bilgi |
yer_012 |
int |
0.12 katsayılı yerleşen sayısı |
yer_012_006 |
int |
0.18 katsayılı yerleşen sayısı |
tyt_012 |
int |
TYT 0.12 katsayılı yerleşen sayısı |
tyt_012_006 |
int |
TYT 0.18 katsayılı yerleşen sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
ort_sira |
list[YksSiraModelDetay] |
Ortalama sıralama detayları |
dusuk_sira |
list[YksSiraModelDetay] |
Düşük sıralama detayları |
| Alan |
Tür |
Bilgi |
tercih_1 |
int |
1. tercih sırası |
tercih_2 |
int |
2. tercih sırası |
tercih_3 |
int |
3. tercih sırası |
tercih_4 |
int |
4. tercih sırası |
tercih_5 |
int |
5. tercih sırası |
tercih_6 |
int |
6. tercih sırası |
tercih_7 |
int |
7. tercih sırası |
tercih_8 |
int |
8. tercih sırası |
tercih_9 |
int |
9. tercih sırası |
tercih_10_sonra |
int |
10. tercih sonrası |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
toplam |
int |
Toplam tercih sayısı |
aday |
float |
Aday sayısı |
ort_tercih |
float |
Ortalama tercih sayısı |
ilk_bir |
int |
İlk tercih yapılan sayısı |
ilk_bir_orn |
float |
İlk tercih oranı |
ilk_uc |
int |
İlk üç tercih yapılan sayısı |
ilk_uc_orn |
float |
İlk üç tercih oranı |
ilk_dokuz |
int |
İlk dokuz tercih yapılan sayısı |
ilk_dokuz_orn |
float |
İlk dokuz tercih oranı |
tercihler |
list[TercihSiraDetay] |
Tercih sırası detayları |
| Alan |
Tür |
Bilgi |
tercih_1 |
int |
1. tercih sırası |
tercih_2 |
int |
2. tercih sırası |
tercih_3 |
int |
3. tercih sırası |
tercih_4 |
int |
4. tercih sırası |
tercih_5 |
int |
5. tercih sırası |
tercih_6 |
int |
6. tercih sırası |
tercih_7 |
int |
7. tercih sırası |
tercih_8 |
int |
8. tercih sırası |
tercih_9 |
int |
9. tercih sırası |
tercih_10 |
int |
10. tercih sırası |
tercih_11 |
int |
11. tercih sırası |
tercih_12 |
int |
12. tercih sırası |
tercih_13 |
int |
13. tercih sırası |
tercih_14 |
int |
14. tercih sırası |
tercih_15 |
int |
15. tercih sırası |
tercih_16 |
int |
16. tercih sırası |
tercih_17 |
int |
17. tercih sırası |
tercih_18 |
int |
18. tercih sırası |
tercih_19 |
int |
19. tercih sırası |
tercih_20 |
int |
20. tercih sırası |
tercih_21 |
int |
21. tercih sırası |
tercih_22 |
int |
22. tercih sırası |
tercih_23 |
int |
23. tercih sırası |
tercih_24 |
int |
24. tercih sırası |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
toplam |
int |
Toplam tercih sayısı |
ilk_bir |
int |
İlk tercih yapılan sayısı |
ilk_bir_orn |
float |
İlk tercih oranı |
ilk_uc |
int |
İlk üç tercih yapılan sayısı |
ilk_uc_orn |
float |
İlk üç tercih oranı |
ilk_on |
int |
İlk on tercih yapılan sayısı |
ilk_on_orn |
float |
İlk on tercih oranı |
ort_tercih |
float |
Ortalama tercih sayısı |
tercihler |
list[OrtTercihDetay] |
Tercih sırası detayları |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
genel |
int |
Genel tercih sayısı |
t_tercih |
int |
Tam tercih sayısı |
k_tercih |
int |
Kayıtlı tercih sayısı |
bos_tercih |
int |
Boş tercih sayısı |
ort_tercih |
int |
Ortalama tercih sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
devlet |
int |
Devlet üniversite tercih sayısı |
vakif |
int |
Vakıf üniversite tercih sayısı |
kibris |
int |
Kıbrıs üniversite tercih sayısı |
yabanci |
int |
Yabancı üniversite tercih sayısı |
| Alan |
Tür |
Bilgi |
isim |
str |
Üniversite ismi |
sayi |
int |
Üniversiteye yapılan başvuru sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
devlet |
list[UniModelDetay] |
Devlet üniversite detayları |
vakif |
list[UniModelDetay] |
Vakıf üniversite detayları |
kibris |
list[UniModelDetay] |
Kıbrıs üniversite detayları |
yabanci |
list[UniModelDetay] |
Yabancı üniversite detayları |
| Alan |
Tür |
Bilgi |
isim |
str |
İl ismi |
sayi |
int |
İl bazındaki tercihlerin sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
iller |
list[IlModelDetay] |
İllerle ilgili tercih detayları |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
ayni |
int |
Ayni tercihler |
farkli |
int |
Farklı tercihler |
kibris |
int |
Kıbrıs tercihler |
onlisans |
int |
Ön lisans tercihler |
yabanci |
int |
Yabancı tercihler |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
ayni |
int |
Ayni tercihler |
farkli |
int |
Farklı tercihler |
kibris |
int |
Kıbrıs tercihler |
lisans |
int |
Lisans tercihler |
yabanci |
int |
Yabancı tercihler |
| Alan |
Tür |
Bilgi |
isim |
str |
Program ismi |
sayi |
int |
Program tercihlerinin sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
programlar |
list[ProgramModelDetay] |
Program detayları |
| Alan |
Tür |
Bilgi |
no |
int |
Kosul numarası |
aciklama |
str |
Kosul açıklaması |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
kosullar |
list[KosulModelDetay] |
Kosul detayları |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
prof |
int |
Profesör sayısı |
docent |
int |
Doçent sayısı |
dou |
int |
Dr. Öğretim Üyesi sayısı |
toplam |
int |
Toplam öğretim üyesi sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
toplam |
int |
Toplam öğrenci sayısı |
toplam_orn |
float |
Toplam öğrenci oranı |
kiz |
int |
Kız öğrenci sayısı |
kiz_orn |
float |
Kız öğrenci oranı |
erkek |
int |
Erkek öğrenci sayısı |
erkek_orn |
float |
Erkek öğrenci oranı |
| Alan |
Tür |
Bilgi |
yil |
str |
Mezuniyet yılı |
toplam |
int |
Toplam mezun sayısı |
erkek |
int |
Erkek mezun sayısı |
kiz |
int |
Kız mezun sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
yillar |
list[MezunYilModelDetay] |
Mezuniyet yılı detayları |
| Alan |
Tür |
Bilgi |
program |
str |
Program adı |
giden |
int |
Giden öğrenci sayısı |
gelen |
int |
Gelen öğrenci sayısı |
| Alan |
Tür |
Bilgi |
osym_kod |
int |
ÖSYM kodu |
year |
int |
Yıl |
degisimler |
list[DegisimModelDetay] |
Öğrenci değişim detayları |
| Alan |
Tür |
Bilgi |
madde |
str |
Yatay geçiş ile ilgili madde |
once |
int |
Önceki öğrenci sayısı |
simdi |
int |
Şu anki öğrenci sayısı |