POST /api/studyincz/programmes/search
Price: 20 credits
Search the accredited study programmes of Czech universities listed on Study in Czechia, by keyword and by study type, language, form, city, university, faculty, field of study, start semester, admission procedure, joint or double degree, tuition, duration and credits. Each programme carries its id, page URL, university and faculty, city with coordinates, study type, forms, field, languages, duration, credits and fee where listed.
Find Czech university study programmes by keyword and filters. Pass a programme url to studyincz/programmes for admission dates, fees, programme code, ISCED code and contacts.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)count integer required — Max number of programmes to return (min: 1; max: 7000)keyword string nullable — Words to match in programme names (examples: "physics", "medicine"; minLength: 1)study_types array nullable — Keep programmes of any of these study types (one of: "bachelor", "master", "follow_up_master", "doctoral", "lifelong_learning"; examples: ["doctoral"])study_languages array nullable — Keep programmes taught in any of these languages (one of: "czech", "english", "german", "french", "italian", "russian"; examples: ["english"])study_forms array nullable — Keep programmes offered in any of these forms (one of: "full_time", "combined", "distance"; examples: ["full_time"])cities array nullable — Keep programmes taught in any of these cities (one of: "Brno", "České Budějovice", "Hradec Králové", "Jihlava", "Jindřichův Hradec", "Lednice", "Liberec", "Litomyšl", "Mladá Boleslav", "Olomouc", "Opava", "Ostrava", "Otrokovice", "Pardubice", "Písek", "Plzeň", "Praha", "Přerov", "Terezín", "Uherské Hradiště", "Ústí nad Labem", "Vodňany", "Zlín"; examples: ["Brno"])university_types array nullable — Keep programmes of universities of any of these types (one of: "public", "private", "state"; examples: ["private"])universities array nullable — Keep programmes of any of these universities: name, alias or id (examples: ["charles-university"], ["Masaryk University"], ["dff458db-470f-4258-9c7c-24f6c05ae9e0"])faculties array nullable — Keep programmes of faculties with any of these names (examples: ["Faculty of Arts"])specializations array nullable — Keep programmes in any of these ISCED fields of study, by field name (examples: ["Physics"], ["Medicine","Dental studies"])start_semesters array nullable — Keep programmes starting in these semesters (one of: "winter", "summer"; examples: ["summer"])admission_procedures array nullable — Keep programmes with any of these admission procedures (one of: "interview", "online", "talent_exam", "without_entrance_exam", "written_test"; examples: ["written_test"])degree_types array nullable — Keep programmes awarding any of these multi-institution degrees (one of: "double_degree", "joint_degree", "multiple_degree"; examples: ["double_degree"])tuition_min number nullable — Lowest annual tuition fee (examples: 1000; min: 0)tuition_max number nullable — Highest annual tuition fee (examples: 5000; min: 0)tuition_currency string nullable — Currency of tuition_min and tuition_max (one of: "CZK", "EUR", "CHF", "GEL", "UAH", "JPY", "KRW", "EGP"; examples: "EUR")duration_min integer nullable — Shortest study duration in years (min: 0; max: 6)duration_max integer nullable — Longest study duration in years (min: 0; max: 6)credits_min integer nullable — Fewest ECTS credits (min: 0; max: 300)credits_max integer nullable — Most ECTS credits (min: 0; max: 300)sort string — Result order (default: "name_asc"; one of: "name_asc", "name_desc", "fee_asc", "fee_desc")@type string (default: "StudyinczProgrammeCard")id string nullablename string nullableurl string nullablealias string nullableuniversity_alias string nullableuniversity_name string nullablefaculty_name string nullablecity string nullablelatitude number nullablelongitude number nullablestudy_type string nullablestudy_forms array (default: [])specialization string nullablestudy_languages array (default: [])duration_years number nullablecredits integer nullablefee_amount number nullablefee_currency string 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 — The entity was not found, or a precondition failed 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.