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

List recent YÖK theses without a search keyword.

Calls YÖK's TezIslemleri endpoint (islem=7 or islem=8) and returns the same result shape as search_yok_tez_detailed. This is the ONLY way to enumerate recent theses since the regular search endpoint requires a keyword.

Useful for:

• Monitoring new theses added to YÖK each week (SON_15_GUN)

• Browsing the current year's full corpus (BU_YIL)

Find YÖK departments (Anabilim Dalı) whose name contains a keyword.

YÖK's regular keyword search canNOT search inside department names. Use this tool first to discover the relevant departments and their codes, then pass the codes you want to 'search_yok_tez_by_anabilim_dali' to retrieve theses from those departments.

Example: keyword='hukuk' returns departments like 'KAMU HUKUKU ANABİLİM DALI' (code 41), 'TİCARET HUKUKU ANABİLİM DALI' (code 906), etc. The LLM can then pick one or several codes to search.

Search YÖK theses filtered by department (Anabilim Dalı) code(s).

This uses YÖK's advanced search path, which filters by department. Unlike 'search_yok_tez_detailed', it does NOT support a free full-text/abstract keyword — but it DOES support filtering by thesis title, author, advisor and index terms, plus the usual type/language/permission/status/year filters.

Workflow:

1. Call 'list_yok_tez_anabilim_dali' with a keyword (e.g. 'hukuk') to get codes.

2. Pass the chosen code(s) here. Multiple codes are searched and merged.

Note: YÖK caps each department's result batch at ~2000; 'total_results_found' reflects YÖK's reported totals while 'results_in_batch' is what was actually fetched.

Fetch rich thesis metadata WITHOUT downloading the PDF.

Returns:

• Advisor name

• Full hierarchical location (University / Institute / Department / Discipline)

• Turkish abstract (full text)

• English abstract (full text)

• Turkish keywords (parsed bilingual pairs)

• English keywords (parsed bilingual pairs)

• Citations in APA, IEEE, MLA, Chicago, and Harvard formats

Much cheaper than get_yok_tez_document_markdown — calls a single JSON endpoint instead of downloading the full PDF. Ideal for surveying or citing theses without needing their body text.

Retrieves a specific YÖK thesis PDF using its detail page URL. It fetches metadata from the detail page, downloads the PDF (if permissible and not cached), isolates the specified PDF page, converts that page to Markdown, and returns the content.