POST /api/studyportals/universities/search
Price: 20 credits
Search Studyportals universities
List universities on Studyportals by name keyword, country, region, study level and discipline, or best-ranked first (without a name keyword), with programme counts per level, rankings and ratings. Use a result id with the universities endpoint for the full profile, or as `university_ids` when searching programmes.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)count integer required — Max number of results (min: 1; max: 6700)text string nullable — Keyword to find universities by name. Results follow the portal's keyword-search order and combine with every other filter. (examples: "delft"; minLength: 1; maxLength: 100)levels array — Universities offering programmes at these study levels. (default: []; one of: "bachelor", "master", "phd", "short"; examples: ["phd"])disciplines array — Universities teaching these disciplines, by id or name. (default: []; examples: ["Business & Management"], ["24"])countries array — University countries, ISO 3166-1 alpha-2. (default: []; examples: ["NL"])regions array — World regions, matched as any-of. (default: []; one of: "europe", "asia", "africa", "north_america", "oceania", "south_america"; examples: ["europe"])area_ids array — State or area ids, as programme results carry in `locations[].area_id`. (default: []; examples: ["3605"])university_ids array — Studyportals university ids. (default: []; examples: ["17","11506"])sort_by string — Result order; `ranking` returns only ranked universities, best first, and cannot be combined with `text` (422). (default: "default"; one of: "default", "ranking")@type string (default: "StudyportalsUniversityCard")id string requiredname string requiredurl string nullablesummary string nullableimage string nullablecity string nullablearea_code string nullablecountry_code string nullablecountry string nullablecampus_count integer nullablecampus_country_codes array (default: [])has_online boolean nullablehas_on_campus boolean nullablehas_blended boolean nullableis_public_funded boolean nullableis_non_profit boolean nullableis_for_profit boolean nullableis_premium boolean nullableglobal_rank integer nullabletop_percent number nullablediscipline_ranks array (default: [])@type string (default: "StudyportalsDisciplineRank")discipline object nullable@type string (default: "StudyportalsDiscipline")id string requiredname string nullableparent_id string nullableposition integer nullablebachelor_count integer nullablemaster_count integer nullablephd_count integer nullableshort_course_count integer nullabledistance_learning_count integer nullablereview_rating object nullable@type string (default: "StudyportalsReviewRating")average number nullablestar_rating number nullablereview_count integer nullablehas_enough_reviews boolean 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.