Search University Programs
search_coursesFull Description
Search university programs abroad. Required: countryName (1–5 countries), courseTag (discipline — use concrete fields like Computer Science, Mechanical Engineering, MBA, Public Health; avoid vague tags like Masters alone), pageIndex (use 1 unless the user asks for another page), and totalPerPage (how many courses the backend should return per page, default 12). Optional: intake (e.g. SEP_2026), tuitionFeesMax as max tuition in INR: prefer whole rupees in the tool call (e.g. 4500000 for ₹45 lakhs). Values 1–500 are accepted as lakhs and converted server-side; do not use USD; this server does not re-filter on fee, degreeCode UG|PG, optional courseDurationMin and courseDurationMax as the same whole-month integer (e.g. both 24 for two years, 12 for one year; you may send only one — the server copies it to the other; not re-filtered locally), sortBy RANKING, sortOrder, and limit (caps how many cards are returned to ChatGPT/the widget after local filters only — not sent to the course API). Returned cards include tuitionFee as overall fee in ₹ lakhs (from tuitionFeeOverallInr) when present, optional tuitionFeeUSD when the API supplies it, intakePeriods[], scholarshipAvailable, logoUrl, and program links.
Parameters (4 required, 8 optional)
countryNamearrayOne or more destination countries to search in, such as ["UK"] or ["Canada", "Ireland"].
courseTagstringProgram subject or discipline (field of study). Use concrete names the catalog understands, e.g. "Computer Science", "Data Science", "Mechanical Engineering", "MBA", "Public Health", "Psychology". Avoid vague phrases like "Masters" alone — pair level with subject or use degreeCode plus a specific discipline.
pageIndexnumberRequired. Pagination index sent to the course API (1 = first page). The model should pass 1 unless the user explicitly asks for another page.
totalPerPagenumberRequired. Page size sent to the course search API — how many raw programs to fetch per request (default 12, max 20). This is not the same as limit.
courseDurationMaxintegerOptional; must equal `courseDurationMin` when both are provided. Same meaning as `courseDurationMin` (months).
courseDurationMinintegerOptional program length in **whole months** sent to the course API (e.g. **24** for two years, **12** for one year). For a single stated length, set **courseDurationMax** to the **same** value (or send only one of the two — the server copies it to the other). Not re-filtered locally.
degreeCodestringDegree level to search for: UG or PG.
UGPGintakearraySpecific intake periods to include, such as ["SEP_2026"] or ["JAN_2027"].
limitnumberMax programs in this tool result and widget after filters (default 6, max 8). Not sent to the course API — use totalPerPage for how many raw rows to fetch per request.
6sortBystringOptional backend sort mode. Use RANKING when the user asks for top or best universities.
RANKINGsortOrderstringSort direction for the selected sort mode.
ASCDESCtuitionFeesMaxintegerOptional max tuition budget in INR. Prefer **whole rupees** sent to the course API (e.g. 4500000 for ₹45 lakhs) so the tool call matches the backend. Integers **1–500** are also accepted as **lakhs** (45 → 4,500,000). Do not use USD. Not re-filtered locally.