POST /api/studyinturkiye/universities
Price: 10 credits
Get one Turkish university profile from Study in Turkiye by its code: founding year, description, website, social and contact details, faculties, facilities, programme, student and staff counts, application dates and required documents, semester dates, students by nationality, languages, the international tuition fee of every programme and whether it is per year or per semester, accredited programmes, language and exam requirements, rankings and research figures, and the photo and video galleries and downloadable documents.
Takes the code studyinturkiye/universities/search returns as `id`. `tuition_fees` lists every programme with its faculty, level, fee and currency; `tuition_fee_period` says whether those fees are per year (`annual`) or per semester (`semester`). `photos`, `videos` and `downloads` carry the media files with their titles.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)university string required — Study in Turkiye university code or university page URL (examples: "115373", "https://www.studyinturkiye.gov.tr/UniversityTurkey/Detail?uId=115373")@type string (default: "StudyinturkiyeUniversity")id string requiredname string nullablefounded_year integer nullabledescription string nullableurl string nullableimage string nullableslides array (default: [])@type string (default: "StudyinturkiyeSlide")image string nullabletitle string nullablecaption string nullableimages array (default: [])website_url string nullablefacebook_url string nullabletwitter_url string nullableinstagram_url string nullableyoutube_url string nullablelinkedin_url string nullableaddress string nullablephone string nullablefax string nullableemail string nullablecontacts array (default: [])@type string (default: "StudyinturkiyeContact")name string nullablephone string nullableemail string nullablefaculty_count integer nullablevocational_school_count integer nullablefaculties array (default: [])vocational_schools array (default: [])sports_facility_count integer nullablesports_team_count integer nullablestudent_club_count integer nullabledormitory_capacity integer nullablelaboratory_count integer nullablecampus_area integer nullableassociate_program_count integer nullablebachelor_program_count integer nullablemaster_program_count integer nullabledoctorate_program_count integer nullableassociate_student_count integer nullablebachelor_student_count integer nullablemaster_student_count integer nullabledoctorate_student_count integer nullablestudent_count integer nullableteaching_staff_count integer nullablestaff_academic_year string nullableprofessor_count integer nullableassociate_professor_count integer nullabledoctor_faculty_member_count integer nullableinstructor_count integer nullableresearch_assistant_count integer nullableforeign_academic_count integer nullableapplication_dates array (default: [])@type string (default: "StudyinturkiyeTerm")level string nullablesemester string nullablestart_date integer nullableend_date integer nullableapplication_documents array (default: [])@type string (default: "StudyinturkiyeDocuments")level string nullabledocuments array (default: [])registration_documents array (default: [])@type string (default: "StudyinturkiyeDocuments")level string nullabledocuments array (default: [])turkish_requirement string nullableturkish_requirement_exams array (default: [])@type string (default: "StudyinturkiyeExam")name string nullablebase_score string nullableforeign_language_requirement string nullableforeign_language_requirement_exams array (default: [])@type string (default: "StudyinturkiyeExam")name string nullablebase_score string nullableonline_application string nullableapplication_fee string nullabledouble_major string nullablecredit_system string nullablesemesters array (default: [])@type string (default: "StudyinturkiyeTerm")level string nullablesemester string nullablestart_date integer nullableend_date integer nullableturkish_prep_exemption string nullablenationalities array (default: [])@type string (default: "StudyinturkiyeNationality")country string nullablestudent_count integer nullablemobility array (default: [])@type string (default: "StudyinturkiyeMobility")academic_year string nullablefarabi_outgoing_count integer nullablefarabi_incoming_count integer nullablemevlana_outgoing_count integer nullablemevlana_incoming_count integer nullableerasmus_outgoing_count integer nullableerasmus_incoming_count integer nullableinterdisciplinary_programs array (default: [])languages array (default: [])tuition_fees array (default: [])@type string (default: "StudyinturkiyeTuitionFee")level string nullablefaculty string nullableprogram string nullablefee number nullablecurrency string nullabletuition_fee_period string nullableaccredited_programs array (default: [])@type string (default: "StudyinturkiyeAccreditation")program string nullablestart_date integer nullableend_date integer nullableperiod_years integer nullablephotos array (default: [])@type string (default: "StudyinturkiyePhoto")image string nullablethumbnail string nullabletitle string nullablevideos array (default: [])@type string (default: "StudyinturkiyeVideo")url string nullableimage string nullablethumbnail string nullabletitle string nullabledownloads array (default: [])@type string (default: "StudyinturkiyeDownload")title string nullableurl string nullableforeign_language_prep string nullableforeign_language_prep_fee number nullableforeign_language_prep_languages array (default: [])orientation_program string nullableturkish_education_center string nullableturkish_prep_fee number nullableturkish_prep_fee_currency string nullableturkish_prep_programs array (default: [])@type string (default: "StudyinturkiyeLevelProgram")level string nullablename string nullablerankings array (default: [])@type string (default: "StudyinturkiyeRanking")name string nullablerank string nullablesports_facility string nullablesports_facilities array (default: [])scientific_event_count integer nullablecampus_facilities array (default: [])research_center_count integer nullabletechnopark string nullabletechnopark_company_count integer nullabletechnopark_rd_staff_count integer nullabletechnopark_project_count integer nullable422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — Study in Turkiye has no profile page for this university code Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.