POST /api/universitaly/programs/search
Price: 5 credits
Search the Italian national catalogue of accredited university and AFAM (art, music and dance) degree programmes by keyword, degree type, length, disciplinary area, degree class, language, admission type, delivery mode and province. Each programme carries its institution, degree type, length, language, degree class and the programme's own web page; university programmes found by filters add admission type, access basis, teaching and delivery mode
Without keyword the catalogue is filtered exactly and university programmes come before AFAM ones. keyword returns closest matches first with fewer fields per programme (no admission, access basis, teaching or delivery mode) and combines only with institution_type and count. AFAM programmes never carry admission, access basis, teaching or delivery mode.
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: 6000)keyword string nullable — Words matched against programme names, closest matches first (examples: "informatica")institution_type string nullable — Only university programmes or only AFAM (art, music and dance) programmes (one of: "university", "afam")degree_type array nullable — Degree types to include (one of: "bachelor", "master", "single_cycle"; examples: ["bachelor","master"])duration_years array nullable — Programme lengths in years to include (one of: 2, 3, 5, 6; examples: [5,6])area string nullable — Disciplinary area of the programme (one of: "Mathematics and computer sciences", "Physical sciences", "Chemical sciences", "Earth sciences", "Biological sciences", "Medical sciences", "Agricultural and veterinary sciences", "Civil engineering, architecture and design", "Industrial and information engineering", "Ancient, philological-literary and historical-artistic sciences", "Historical, philosophical, pedagogical and psychological sciences", "Legal sciences", "Economics and statistics", "Political and social sciences", "Music")degree_class string nullable — Ministerial degree class code (examples: "L-31", "LM-18")language array nullable — University programmes taught in these languages (one of: "italian", "english"; examples: ["english"])admission_type array nullable — University programmes with these admission types (one of: "open", "admission_test", "limited_places"; examples: ["open"])delivery_mode array nullable — University programmes delivered in these modes (one of: "in_person", "blended", "mostly_remote", "remote"; examples: ["remote"])province string nullable — Two-letter Italian province code of AFAM programmes (examples: "MI", "RM")sort string nullable — Order by programme name (one of: "name_asc", "name_desc")@type string (default: "UniversitalyProgram")id integer nullableinstitution_type string required (one of: "university", "afam")name string requiredname_en string nullableinstitution_name string nullableinstitution_id integer nullableinstitution_code string nullablewebsite_url string nullableacademic_year string nullabledegree_type string nullabledegree_type_en string nullabledegree_type_id integer nullableduration_years integer nullablelanguage string nullablearea_code string nullablearea string nullabledegree_class object nullable@type string (default: "UniversitalyDegreeClass")id integer nullablecode string nullablename string nullablelevel string nullableprevious_class_id integer nullabletotal_credits integer nullablecategory integer nullablecharacterising_field_count integer nullablearea_id integer nullablecun_area integer nullableinterclass object nullable@type string (default: "UniversitalyDegreeClass")id integer nullablecode string nullablename string nullablelevel string nullableprevious_class_id integer nullabletotal_credits integer nullablecategory integer nullablecharacterising_field_count integer nullablearea_id integer nullablecun_area integer nullableaccess_basis string nullableadmission_type string nullableteaching_mode string nullabledelivery_mode string nullabledelivery_mode_code string nullabledelivery_mode_en string nullableis_interuniversity boolean nullablecity 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 — No programme matches this combination of filters, or the degree class code is unknown 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.