# NTHU Data API **Canonical:** https://apis.io/apis/nthu/nthu-data-api/ **Provider:** National Tsing Hua University — https://apis.io/providers/nthu/ **Base URL:** https://api.nthusa.tw **Documentation:** https://api.nthusa.tw/docs NTHU Data API is one of 4 APIs that [National Tsing Hua University](https://apis.io/providers/nthu/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Campus, Open Data, Course Catalog, Transit, and Dining. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a JSON-LD context. A live, keyless, MIT-licensed FastAPI service publishing 22 paths over NTHU campus data — announcements by unit, campus bus routes and schedules, the course catalog and course search, department directories, dining venues and opening hours, real-time campus electricity usage, library study-space availability and lost-and-found, campus locations, and unit newsletters. It publishes its own OpenAPI description at /openapi.json (serving 3.1.0 as of 2026-08-30; the archived pristine copy in openapi/_original/ declares 3.0.3, so upstream has since bumped its emitted version) and Swagger UI at /docs. Split per tag by our refine pipeline into the nine documents referenced below; the pristine source contract is openapi/_original/nthu-data-api.yaml. ## Operations (23) | Method | Path | Summary | |---|---|---| | GET | `/announcements/` | Get Announcements | | GET | `/announcements/sources` | Get Announcements List | | GET | `/announcements/lists/departments` | List Announcement Departments | | GET | `/buses/routes` | Get Bus Route Metadata | | GET | `/buses/info/stops` | Get Bus Stops Information | | GET | `/buses/schedules` | Get Bus Schedules | | GET | `/buses/stops/{stop_name}` | Get Stop Bus Information By Stop | | GET | `/courses/` | Get All Courses | | GET | `/courses/search` | Search Courses By Field And Value | | POST | `/courses/search` | Search Courses By Condition | | GET | `/courses/lists/{list_name}` | List Courses By Type | | GET | `/departments/` | Get All Departments | | GET | `/departments/search` | Fuzzy Search Departments And People | | GET | `/dining/` | Get Dining Data | | GET | `/dining/open` | Get Open Restaurants | | GET | `/energy/electricity_usage` | Get Realtime Electricity Usage | | GET | `/libraries/space` | Get Library Space Availability | | GET | `/libraries/lost_and_found` | Get Library Lost And Found Items | | GET | `/libraries/rss/{rss_type}` | Get Library Rss Data | | GET | `/locations/` | Get All Locations | | GET | `/locations/search` | Fuzzy Search Locations | | GET | `/newsletters/` | Get All Newsletters | | GET | `/newsletters/{newsletter_name}` | Get Newsletter By Name | ## Machine-readable artifacts (20) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/_original/nthu-data-api.yaml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-announcements-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-buses-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-courses-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-departments-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-dining-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-energy-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-libraries-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-locations-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/openapi/nthu-newsletters-api-openapi.yml - **Documentation** — https://api.nthusa.tw/docs - **GitHub** — https://github.com/NTHU-SA/NTHU-Data-API - **SourceCode** — https://github.com/NTHU-SA/NTHU-Data-API - **License** — https://github.com/NTHU-SA/NTHU-Data-API/blob/main/LICENSE - **Vocabulary** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/vocabulary/nthu-vocabulary.yml - **JSONLD** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/json-ld/nthu-context.jsonld - **Rules** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/rules/nthu-rules.yml - **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/agentic-access/nthu-agentic-access.yml - **Errors** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/errors/nthu-errors.yml - **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/nthu/refs/heads/main/lifecycle/nthu-lifecycle.yml ## Other National Tsing Hua University APIs (3) - [NTHU Academic Information System OAuth 2.0 Service](https://apis.io/apis/nthu/nthu-oauth-api/) - [NTHU Research Portal (Esploro tenant)](https://apis.io/apis/nthu/nthu-research-portal/) - [NTHU Library Discovery (Primo VE tenant)](https://apis.io/apis/nthu/nthu-library-discovery/) ## Tags Campus, Open Data, Course Catalog, Transit, Dining, Library, Energy --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nthu/nthu-data-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nthu/.