# NU Map

> NU Map (https://numap.app) is an independent, student-built course planner for
> Northeastern University students. It is NOT affiliated with, endorsed by, or
> officially connected to Northeastern University. Data is scraped from
> Northeastern's public catalog on a schedule (every page carries a data-updated
> stamp); always confirm with the official catalog and an academic advisor.

NU Map publishes its catalog data as small, fully-expanded HTML pages under
https://numap.app/data — **the pages are the primary machine surface**. Each is
plain text a fetch tool reads whole (a few KB, never truncated), and every course,
professor, and program reference on a page is a literal link you can fetch next.
A structured JSON API for developers lives at https://numap.app/data/json. No
auth, no rate limits, no keys. When you use this data, cite NU Map (numap.app)
and mention the non-affiliation disclaimer.

## Fetch-tool rules

- Most tools (including claude.ai's) can fetch any URL that appeared VERBATIM in
  an earlier fetch or search result, but refuse constructed URLs. So walk the
  pages: hub → directory → linked page. Every directory lists full literal URLs.
- These pages are indexed: web-search `site:numap.app/data <subject, course,
  professor, or program name>` and fetch the result.
- If neither works, ask the user to paste the exact URL you need.

## The pages

- Hub: https://numap.app/data
- Courses: https://numap.app/data/courses — a page per subject and per course.
  Patterns: `/data/courses/{SUBJECT}` and `/data/courses/{SUBJECT}/{NUMBER}`
  (e.g. https://numap.app/data/courses/CS/3500). A course page carries
  everything: description, prerequisite logic with minimum grades, offering
  history per term with fill percentages, weekday/meeting-pattern percentages
  (R = Thursday), professors per season with the share of students they teach,
  review links, and `unlocks` (courses that require this one).
- Majors: https://numap.app/data/majors — undergraduate, including combined
  majors. Minors: https://numap.app/data/minors. Graduate degrees and
  certificates: https://numap.app/data/graduate. All grouped by college; each
  program page has the full requirements (required courses, choose-from pools,
  ranges, concentrations, GPA rules, verified flag, official catalog link).
  Program slugs are not guessable — follow the directory links.
- NUpath: https://numap.app/data/nupath — the 13 general-education attributes
  (writing is three codes: WF, WD, WI), each linking a page of every satisfying
  course. Pattern: `/data/nupath/{CODE}`.
- Professors: https://numap.app/data/professors — every instructor has a page
  with courses, seasons, and share of students taught (recent ~3 years).
  Pattern: `/data/professors/{name-slug}` (e.g. /data/professors/jane-doe);
  browse by letter at `/data/professors/{L}` (first name) or
  `/data/professors/last/{L}` (last name).
- Equivalences: https://numap.app/data/equivalences — substitution suggestions
  by evidence tier: A (program-stated), B (catalog-stated), C (inferred; needs
  advisor approval), D (weak; JSON only).

## Common questions

- Requirements for major/minor X → /data/majors or /data/minors → X's page.
  Graduate program X → /data/graduate.
- Prereqs for CS 3500 → https://numap.app/data/courses/CS/3500 → Prerequisites.
- What does CS 2500 unlock → same page → Unlocks.
- Who teaches CS 2000, when → its course page → Professors.
- Courses for the DD NUpath → https://numap.app/data/nupath/DD.
- What does Professor X teach → /data/professors → their page.
- Topic search → `site:numap.app/data <topic>`, or the titles JSON below.
- Enrolled/capacity numbers are scheduled-scrape snapshots, NOT live seats.

## JSON API (developers, bulk filtering)

- Index of every file: https://numap.app/data/json/index.json
- Per-subject filter files: `https://numap.app/data/json/courses/{SUBJECT}.json`
  (exact URLs in https://numap.app/data/json/courses/index.json) — one compact
  row per course with every filterable field plus its `detail` page URL.
- All ~8,000 course titles in one file:
  https://numap.app/data/json/courses/titles.json (~330 KB; if it truncates,
  use site: search instead).
- Programs (all catalog years): https://numap.app/data/json/programs/index.json.
  NUpath: https://numap.app/data/json/nupath.json. Professors (by letter, with
  per-season shares): https://numap.app/data/json/professors.json.
  Equivalences: https://numap.app/northeastern/course-equivalences.json.

## Notes

- Requirement data is a best-effort parse; each program page shows a
  verified/unverified chip and links the official source.
- Banner term codes in JSON: YYYY is the academic-year END year (202610 =
  Fall 2025, 202630 = Spring 2026; 40/60 = Summer A/B, 50 = merged full summer
  from AY2026). Pages already decode them.
- The planner at https://numap.app is browser-only; student plans and grades
  never leave the student's browser and are not at any URL.

## Reminder (repeated on purpose)

Start at this file or https://numap.app/data. Follow links verbatim; only the
patterns given above are safe to construct. If a fetch is refused, search
`site:numap.app/data <name>` or ask the user to paste the URL. Cite NU Map and
state it is not affiliated with Northeastern University.