POST /api/studyinkorea/universities
Price: 20 credits
Get one university from Korea's official Study in Korea catalogue by its code: founding year, ownership, address, website, international student, faculty and student counts, language courses, scholarships, dormitories, tuition per semester in USD, contacts, admission periods per degree level and every programme with its id
Each entry in `programs` carries the `url` studyinkorea/programs takes for that programme's detail. `name_ko` and `name_en` hold a programme's Korean and English names; `name_en` is empty where the university gives no English name.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)university string required — Study in Korea university code or university page URL (examples: "100320", "https://www.studyinkorea.go.kr/ko/search/universityInfo.do?tab=univ-basic-info&univCd=100004")language string — Language of the returned texts and labels (default: "en"; one of: "en", "ko"; examples: "en", "ko")@type string (default: "StudyinkoreaUniversity")id string requiredname string nullableimage string nullablecover string nullablefounded_year integer nullablefounded_date integer nullableownership string nullableregion string nullableis_ieqas_certified boolean (default: false)address string nullablewebsite string nullablelanguage_center_url string nullablebrochure_url string nullablesocial_urls array (default: [])slogan string nullableinternational_students object nullable@type string (default: "StudyinkoreaInternationalStudents")total_count integer nullablebachelor_count integer nullablemaster_count integer nullabledoctorate_count integer nullablecombined_master_doctorate_count integer nullableother_count integer nullablefaculty object nullable@type string (default: "StudyinkoreaFaculty")total_count integer nullableprofessor_count integer nullableassistant_professor_count integer nullableadjunct_professor_count integer nullablehourly_lecturer_count integer nullableother_count integer nullablestudents object nullable@type string (default: "StudyinkoreaStudents")total_count integer nullableundergraduate_count integer nullablemaster_count integer nullabledoctorate_count integer nullablecombined_master_doctorate_count integer nullableother_count integer nullablelanguage_courses array (default: [])@type string (default: "StudyinkoreaLanguageCourse")department string nullablestaff string nullableemail string nullablename string nullablequalifications string nullablecapacity string nullableperiod string nullabletuition string nullablecost string nullableupdated_date integer nullablescholarships array (default: [])@type string (default: "StudyinkoreaScholarship")department string nullablestaff string nullableemail string nullableid string nullablename string nullablename_ko string nullablename_en string nullabletype string nullablequalifications string nullablebenefits string nullableamount string nullableupdated_date integer nullabledormitories array (default: [])@type string (default: "StudyinkoreaDormitory")department string nullablestaff string nullableemail string nullablename string nullablequalifications string nullablecapacity integer nullabledetails string nullableupdated_date integer nullablecafeterias array (default: [])@type string (default: "StudyinkoreaCafeteria")name string nullablemeal_cost number nullablehas_breakfast boolean nullablehas_lunch boolean nullablehas_dinner boolean nullablepart_time_jobs array (default: [])@type string (default: "StudyinkoreaPartTimeJob")department string nullablestaff string nullableemail string nullablename string nullablequalifications string nullabledetails string nullableupdated_date integer nullablespecial_fields string nullableenglish_courses string nullableother_language_courses string nullablespecial_fields_updated_date integer nullablefacilities string nullablefacilities_updated_date integer nullabletuition array (default: [])@type string (default: "StudyinkoreaTuition")field string requiredbachelor number nullablemaster number nullabledoctorate number nullablecombined_master_doctorate number nullableassociate number nullableother number nullabletuition_updated_date integer nullablecontacts array (default: [])@type string (default: "StudyinkoreaContact")program string nullablestaff string nullableemail string nullablecontacts_updated_date integer nullablespecial_courses array (default: [])@type string (default: "StudyinkoreaSpecialCourse")name string nullableperiod string nullablelanguage string nullableenrollment_period string nullablequota string nullabletuition string nullabledocuments string nullablescholarship string nullabledescription string nullableupdated_date integer nullableadmissions array (default: [])@type string (default: "StudyinkoreaAdmission")degree string nullabledegree_code string nullableenrollment_period string nullableapplication_period string nullableduration string nullablenote string nullableattachments array (default: [])@type string (default: "StudyinkoreaFile")name string nullableurl string requireddepartment_count integer nullableupdated_date integer nullableprogram_count integer nullableprograms array (default: [])@type string (default: "StudyinkoreaUniversityProgram")id string requireddegree_code string nullablename string nullablename_ko string nullablename_en string nullablefield_group string nullablefield_group_ko string nullablefield_group_en string nullablecollege string nullableenglish_share string nullableenglish_requirement string nullablewebsite string nullableremark string nullableurl string requiredvideos array (default: [])@type string (default: "StudyinkoreaVideo")title string nullableurl string requiredgallery array (default: [])@type string (default: "StudyinkoreaGalleryImage")image string requiredtitle string nullableurl string required422 — 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 — No university is listed under this 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.