| name | alterlab-yokatlas |
| description | Retrieves Türkiye higher-education program and admission statistics from YÖK Atlas (yokatlas.yok.gov.tr) — quotas (kontenjan), placements (yerleşen), minimum admission scores (taban puan), success ranks (başarı sırası), and per-title academic-staff counts — via the keyless yokatlas-py (>=0.6.0, MIT) wrapper over the JSON API at /api/tercih-kilavuz/ (search, universiteler, universite-programlar), with SearchFilters for puan türü (SAY/SÖZ/EA/DİL/TYT), university type (DEVLET/VAKIF), province, and success-rank ranges. Use when the request mentions YÖK Atlas, program statistics, kontenjan/quota data, taban puan/minimum admission score, başarı sırası/success rank, placement counts, or program staff counts for institutional research, program benchmarking, or student advising. For an academic's CV/profile/affiliation prefer alterlab-yok-akademik; for theses prefer alterlab-yok-tez. Legacy PHP endpoints are dead post-April-2026; only the JSON API is used. Part of the AlterLab Academic Skills suite. |
| license | MIT |
| allowed-tools | Read Write Edit Bash(python:*) Bash WebFetch |
| compatibility | No API key required — wraps the keyless YÖK Atlas JSON API (/api/tercih-kilavuz/) through yokatlas-py v0.6.0 (MIT, Python >=3.10) run via `uv run --with yokatlas-py python`; degrades to a documented manual lookup when offline |
| metadata | {"skill-author":"AlterLab","version":"1.0.0","last_updated":"2026-06-06","depends_on":"alterlab-yok-akademik (academic profiles), alterlab-research-lookup (publication enrichment)"} |
YÖK Atlas — Türkiye University Program & Admission Statistics
Retrieves official program-level statistics from YÖK Atlas (Yükseköğretim
Kurulu Atlası — the Council of Higher Education's program atlas) for any
undergraduate (lisans) or associate (önlisans) program in Türkiye: quotas,
placements, minimum admission scores, success ranks, and academic-staff head
counts by title. It wraps the keyless YÖK Atlas JSON API through the
maintained yokatlas-py package, so the same query yields the same structured
records — no HTML scraping, no API key.
This is the statistics skill. It does not look up an individual
academic's CV, publications, or affiliation — that is alterlab-yok-akademik,
a separately architected YÖK system (see the routing table below).
When to Use This Skill
Use it when the user wants program- or university-level numbers from YÖK Atlas:
YÖK Atlas'tan Boğaziçi Bilgisayar Mühendisliği taban puanını ve başarı sırasını çıkar
Compare the kontenjan and yerleşen counts for all Tıp programs at state universities
What was the minimum SAY score for Hacettepe Elektrik-Elektronik Mühendisliği last year?
List every university in YÖK Atlas and the academic-staff counts for a given program
How many professors vs. araştırma görevlisi does this department have?
→ Run scripts/yokatlas_lookup.py (a thin yokatlas-py wrapper), read the JSON,
then present the requested statistics as a table. Always state the data year and
that figures come from YÖK Atlas.
Canonical Turkish terms (English gloss on first use)
| Turkish | Gloss | API field |
|---|
| kontenjan | quota (seats offered) | kontenjan |
| yerleşen | placed (students enrolled) | yerlesen |
| taban puan | minimum admission score | min_puan |
| başarı sırası | success rank (national rank of last placed student) | basari_sirasi |
| puan türü | score type (SAY/SÖZ/EA/DİL/TYT) | puan_turu |
| lisans / önlisans | bachelor's / associate degree | birim_turu_id 46 / 47 |
| kılavuz kodu |
