Agent API

Query course catalogs and degree plans over a JSON REST API. Copy the docs as Markdown to give your agent full context.

Base URL

https://courses.coolstuff.work

{
  "data": { ... },
  "meta": { "total": 42, "count": 20, "query": "..." }
}

qText search (code, title, department, syllabus, tags)

typeOn /search: all, courses, or degrees

departmentFilter by department name or slug

branchFilter by branch slug (e.g. cps, ece)

tagFilter by tag (e.g. core, elective)

limitMax results (default 50, max 100)

offsetPagination offset

GET/api/v1

Discovery — lists all available endpoints

GET/api/v1/search

Unified search across courses and degrees

Params: q, type, department, branch, tag, limit, offset

GET/api/v1/courses

List or search courses

Params: q, department, branch, tag, limit, offset

GET/api/v1/courses/{code}

Get a single course by code

GET/api/v1/departments

List all departments

GET/api/v1/departments/{slug}

Full catalog for a department

GET/api/v1/degrees

List or search degree programs

Params: q, limit, offset

GET/api/v1/degrees/{slug}

Full degree plan with semesters and elective pools

Course codes contain spaces — URL-encode them in path segments (e.g. MAT%202122).
Use /api/v1/search for broad queries; use resource endpoints when you know the entity type.
Paginate with limit and offset for large result sets.
All endpoints return JSON and support CORS.