Skip to main content

Unofficial for YokAtlas API

Project description

▪ YokAPI

  • YokAtlas için resmi olmayan API
  • Unoffical API for YokAtlas

Made with Python

Repo Size GitHub All Releases Profile Views GitHub license GitHub last commit PyPI Downloads PyPI Status PyPI Version

İ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

  • Dokümantasyon düzenlenecek
  • Akademik YÖK API eklenecek
  • Model yapısı düzenlenecek

📌 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.

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

ModelDetay

Alan Tür Bilgi
sayi int Sayısal değer
orn float Oran değeri

Cinsiyet

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

Bolgeler

Alan Tür Bilgi
toplam ModelDetay Genel toplam verileri
akdeniz ModelDetay Akdeniz bölgesi verileri
dogu_anadolu ModelDetay Doğu Anadolu bölgesi verileri
ege ModelDetay Ege bölgesi verileri
guneydogu_anadolu ModelDetay Güneydoğu Anadolu verileri
ic_anadolu ModelDetay İç Anadolu bölgesi verileri
karadeniz ModelDetay Karadeniz bölgesi verileri
marmara ModelDetay Marmara bölgesi verileri
belli_degil ModelDetay Bölgesi belli olmayan veriler

ModelDetayCinsiyet

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ı

SehirDurum

Alan Tür Bilgi
toplam ModelDetayCinsiyet Toplam şehir verileri
ayni ModelDetayCinsiyet Aynı şehirde kalanlar
farkli ModelDetayCinsiyet Farklı şehire gidenler
belli_degil ModelDetayCinsiyet Şehir bilgisi belli olmayanlar

CografiBolgeler

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

Il

Alan Tür Bilgi
isim str Şehir adı
sayi int Sayısal değer
orn float Oran değeri

Iller

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
sehirler list[Il] Şehir bazlı detaylar

OgrenimDurumu

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
toplam ModelDetay Toplam kayıtlar
lise_yeni ModelDetay Yeni lise mezunları
lise_mezun ModelDetay Önceki lise mezunları
uni_ogr ModelDetay Üniversite öğrencileri
uni_mezun ModelDetay Üniversite mezunları
diger ModelDetay Diğer kategoriler

YilModelDetay

Alan Tür Bilgi
yil str Mezuniyet yılı
sayi int Sayısal değer
orn float Oran değeri

MezunYil

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
yillar list[YilModelDetay] Mezuniyet yılları

LiseAlanModelDetay

Alan Tür Bilgi
alan str Lise alan adı
sayi int Sayısal değer
orn float Oran değeri

LiseAlan

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
alanlar list[LiseAlanModelDetay] Lise alan detayları

LiseTip

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
genel_lise list[LiseAlanModelDetay] Genel lise detayları
meslek_lise list[LiseAlanModelDetay] Meslek lisesi detayları

LiseModelDetay

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ı

Liseler

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
liseler list[LiseModelDetay] Lise bazlı detaylar

LiseYerlesme

Alan Tür Bilgi
kont_turu str Kontenjan türü
isim str Lise ismi

OkulBirinciKontenjan

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

TabanPuan

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

TabanPuanOnlisans

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
puanlar list[PuanOnlisansModelDetay] Önlisans puan detayları
siralar list[SiraModelDetay] Başarı sıraları

SonProfil

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

DersModelDetay

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

YksNet

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ı

YksPuanModelDetay

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ı

YksPuan

Alan Tür Bilgi
osym_kod int ÖSYM program kodu
year int Yıl
ort_puan list[YksPuanModelDetay] Ortalama puanlar
dusuk_puan list[YksPuanModelDetay] Düşük puanlar

YksSiraModelDetay

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ı

YksSira

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ı

TercihSiraDetay

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ı

TercihIstatistik

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ı

OrtTercihDetay

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ı

OrtTercih

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ı

TercihGenel

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ı

TercihUniTur

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ı

UniModelDetay

Alan Tür Bilgi
isim str Üniversite ismi
sayi int Üniversiteye yapılan başvuru sayısı

TercihUni

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ı

IlModelDetay

Alan Tür Bilgi
isim str İl ismi
sayi int İl bazındaki tercihlerin sayısı

TercihIl

Alan Tür Bilgi
osym_kod int ÖSYM kodu
year int Yıl
iller list[IlModelDetay] İllerle ilgili tercih detayları

TercihFark

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

TercihFarkOnlisans

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

ProgramModelDetay

Alan Tür Bilgi
isim str Program ismi
sayi int Program tercihlerinin sayısı

TercihProgram

Alan Tür Bilgi
osym_kod int ÖSYM kodu
year int Yıl
programlar list[ProgramModelDetay] Program detayları

KosulModelDetay

Alan Tür Bilgi
no int Kosul numarası
aciklama str Kosul açıklaması

YerlesmeKosul

Alan Tür Bilgi
osym_kod int ÖSYM kodu
year int Yıl
kosullar list[KosulModelDetay] Kosul detayları

OgretimUyesi

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ı

KayitliOgrenci

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ı

MezunYilModelDetay

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ı

MezunOgrenci

Alan Tür Bilgi
osym_kod int ÖSYM kodu
year int Yıl
yillar list[MezunYilModelDetay] Mezuniyet yılı detayları

DegisimModelDetay

Alan Tür Bilgi
program str Program adı
giden int Giden öğrenci sayısı
gelen int Gelen öğrenci sayısı

DegisimOgrenci

Alan Tür Bilgi
osym_kod int ÖSYM kodu
year int Yıl
degisimler list[DegisimModelDetay] Öğrenci değişim detayları

YatayGecisModelDetay

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ı

YatayGecis

Alan Tür Bilgi
osym_kod int ÖSYM kodu
year int Yıl
gelen list[YatayGecisModelDetay] Gelen öğrenciler için detaylar
giden list[YatayGecisModelDetay] Giden öğrenciler için detaylar

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yokapi-1.0.0.tar.gz (30.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yokapi-1.0.0-py3-none-any.whl (24.8 kB view details)

Uploaded Python 3

File details

Details for the file yokapi-1.0.0.tar.gz.

File metadata

  • Download URL: yokapi-1.0.0.tar.gz
  • Upload date:
  • Size: 30.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for yokapi-1.0.0.tar.gz
Algorithm Hash digest
SHA256 6dd4f87cf37bd0729f5b192aeb30b2114077c37ec40da8abfa24fc2101f23c64
MD5 1ab13c179b5dc5268621481ed083a706
BLAKE2b-256 222c2a7190a7cc10780cd4fe9b27af0e40664ca5a1d883bdc201a85185c11728

See more details on using hashes here.

File details

Details for the file yokapi-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: yokapi-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 24.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for yokapi-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7250a8b79f2e15378d1bb7f9e9ff4de936ecee65759f835c0bd3e4c6c83a8231
MD5 915ddd87d0aa769b209648f4f0b165ad
BLAKE2b-256 daf06edbff1328bd2f293be1a3e0f71e3f65ecce9c929f6223ed7c110b61efed

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page