YÖK Atlas APIyokatlas.yok.gov.tr ↗
Access Turkey's official higher education database via 9 endpoints. Search programs, filter by city and score type, retrieve admission stats, quotas, and graduate exam results.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/55fafd1a-550d-412b-a1c6-91ad9e1aac17/list_universities' \ -H 'X-API-Key: $PARSE_API_KEY'
List all Turkish universities with their internal IDs and names. Returns the complete list of universities available in the YÖK Atlas system.
No input parameters required.
{
"type": "object",
"fields": {
"universities": "array of university objects with university_id (integer) and name (string)"
},
"sample": {
"data": {
"universities": [
{
"name": "ABDULLAH GÜL ÜNİVERSİTESİ (KAYSERİ)",
"university_id": 173499
},
{
"name": "ACIBADEM MEHMET ALİ AYDINLAR ÜNİVERSİTESİ (İSTANBUL)",
"university_id": 326654
}
]
},
"status": "success"
}
}About the YÖK Atlas API
The YÖK Atlas API exposes 9 endpoints covering Turkey's complete official higher education catalog — universities, degree programs, admission scores, quotas, and graduate exam outcomes. The search_programs endpoint alone returns fields like basariSirasi (success rank), minPuan (minimum admission score), kontenjan (quota), and tuition, filterable by city, score type, program group, and university. Other endpoints surface full university profiles, graduate exam statistics (TUS, DUS, KPSS), and reference lists for cities and program groups.
University and Program Discovery
Start with list_universities to retrieve every Turkish university along with its internal university_id. Pass that ID to get_university_programs to list all programs offered, specifying level as lisans (bachelor) or onlisans (associate). Each program object includes a code, name, and url. For a richer university profile — name, type, city, website, address, and logo URL — call get_university_detail with the same university ID.
Program Search and Filtering
search_programs is the main filtering endpoint. It accepts optional parameters including city_code (from list_cities), score_type (SAY, EA, SÖZ, DİL, TYT), university_id, and program_group_id (from list_programs). Results are paginated via zero-based page and size parameters. Each result in the results array includes university_name, program_name, program_group, faculty, city, and score_type. Sort by basariSirasi, minPuan, kontenjan, or universiteAd using the sort_by and direction parameters. For a global keyword search across both universities and programs, search accepts a term string and returns typed results with sonuc, kod, etiket, and etiket2 fields.
Program Details and Graduate Statistics
get_program_details accepts an ÖSYM program_code (obtainable from get_university_programs) and an optional panels parameter to limit which data panels are returned. The details object keys are panel names, each containing tabular data covering scores, ranks, gender distribution, and academic staff for that program.
get_graduate_success returns per-university outcome data for centralized graduate exams. Pass exam_id as an integer: 1 for TUS (medical specialty), 4 for DUS (dental specialty), 6 for KPSS (civil service). The response includes headers and rows arrays that can be mapped into a structured table of exam performance by institution.
- Build a Turkish university comparison tool using admission scores and success ranks from
search_programs. - Map program availability by city using
city_codefiltering and thelist_citiesreference endpoint. - Track medical school graduate performance across universities via
get_graduate_successwith TUS exam data. - Generate program guides filtered by score type (SAY, EA, SÖZ) for prospective students preparing for the YKS exam.
- Populate a university directory with name, type, city, website, and logo using
get_university_detail. - Cross-reference quota (
kontenjan) and minimum score data fromsearch_programsto analyze admission competitiveness. - Build a program recommendation engine by combining
list_programsgroup IDs withsearch_programsfilters.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does YÖK Atlas have an official public developer API?+
What does `search_programs` actually return, and how is pagination handled?+
search_programs returns an array of program objects each containing university_name, program_name, program_group, faculty, city, score_type, university_id, and kilavuz_kodu. The response also includes total_elements (total matching programs), total_pages, and page (current zero-based page index). Set page and size to paginate through large result sets; size can go up to 100 per request.Does the API return historical admission score data across multiple years?+
get_program_details endpoint returns multi-panel tabular data that includes historical score and rank information for programs, and the depth of that history depends on what YÖK Atlas publishes for each program. The search_programs and search endpoints reflect current-year catalog data. You can fork this API on Parse and revise it to add a dedicated year-range filtering endpoint if you need a cleaner interface to historical panels.Is data available for programs at universities outside Turkey?+
list_cities includes some international locations alongside Turkish cities, but program and university coverage is focused on institutions within Turkey's higher education system as indexed by YÖK. Institutions outside that scope are not covered. You can fork the API on Parse and revise it to add endpoints targeting other national higher education registries if international coverage is needed.Can I retrieve scholarship or financial aid details through `get_program_details`?+
get_program_details returns panel data covering scores, ranks, gender distribution, and academic staff. search_programs returns tuition fee data. Dedicated scholarship or financial aid breakdowns are not currently exposed as distinct fields. You can fork this API on Parse and revise it to surface additional financial detail panels if they are available in the source data.