Search Yok Tez Detailed
search_yok_tez_detailedSearch the YÖK National Thesis Center by keywords across specific fields like title, author, or advisor, with filters for language, year, and access permission.
Instructions
Search the YÖK National Thesis Center.
YÖK's API was redesigned in 2026: searches are now keyword-based against ONE field type at a time (with optional additional keyword slots joined by AND/OR), plus a small set of filter dropdowns (type, language, permission, status, years).
University/institute/department text filters are no longer respected by YÖK and have been removed from this tool. The 'thesis_number' parameter has also been removed since YÖK no longer supports direct lookup by thesis number through this endpoint.
Provide either:
'keyword' (preferred — combine with 'search_field' if you need to restrict the search to a specific field like title or author), or
one of the legacy aliases (thesis_title, author_name, advisor_name, subject_headings, index_terms, abstract_text) which auto-set 'search_field'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number of the search results. | |
| keyword | No | Primary search term — what to look for in YÖK theses. E.g. 'yapay zeka', 'machine learning', 'AHMET YILMAZ'. Either this or one of the legacy field-specific parameters (thesis_title, author_name, advisor_name, subject_headings, index_terms, abstract_text) must be provided. | |
| language | No | Filter by thesis language. | 0 |
| year_end | No | End year for the search range (e.g. '2025'). '0' = no upper bound. | 0 |
| keyword_2 | No | Second search term (optional). Combined with 'keyword' via 'operator_1'. | |
| keyword_3 | No | Third search term (optional). Combined with 'keyword_2' via 'operator_2'. | |
| match_type | No | ICERSIN = keyword appears anywhere (default). TAM_IFADE = exact phrase match. | 2 |
| operator_1 | No | Boolean operator between 'keyword' and 'keyword_2'. | and |
| operator_2 | No | Boolean operator between 'keyword_2' and 'keyword_3'. | and |
| year_start | No | Start year for the search range (e.g. '2020'). '0' = no lower bound. | 0 |
| author_name | No | DEPRECATED legacy alias. If provided, search_field is set to YAZAR. | |
| index_terms | No | DEPRECATED legacy alias. If provided, search_field is set to ANAHTAR_KELIME. | |
| thesis_type | No | Filter by thesis type. | 0 |
| advisor_name | No | DEPRECATED legacy alias. If provided, search_field is set to DANISMAN. | |
| search_field | No | Which field to search the keyword(s) in. TUMU = all fields (default), TEZ_ADI = title, YAZAR = author, DANISMAN = advisor, KONU = subject, ANAHTAR_KELIME = index/keyword terms, OZET = abstract. | 7 |
| thesis_title | No | DEPRECATED legacy alias. If provided, search_field is set to TEZ_ADI and 'keyword' is filled from this. | |
| abstract_text | No | DEPRECATED legacy alias. If provided, search_field is set to OZET. | |
| thesis_status | No | Filter by approval status. Defaults to 'Onaylandı' (approved). | 3 |
| results_per_page | No | Number of results to display per page. | |
| subject_headings | No | DEPRECATED legacy alias. If provided, search_field is set to KONU. | |
| permission_status | No | Filter by PDF access permission (İzinli / İzinsiz). | 0 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| theses | No | List of found theses summaries. | |
| total_pages | No | Total number of pages available based on results_in_batch and limit_per_page. | |
| current_page | Yes | The current page number of the search results. | |
| error_message | No | Error message if the search failed or no results were found. | |
| results_in_batch | No | Number of results actually returned in the current HTML batch. YÖK caps this at ~2000 even when total_results_found is larger. | |
| total_results_found | No | Total number of results found as reported by YÖK. | |
| query_used_parameters | No | The parameters used for this search. |