---
title: "Search Courses By Field And Value"
method: GET
path: "/courses/search"
tags: ["Courses"]
---

# Search Courses By Field And Value

`GET /courses/search`

根據提供的欄位和值搜尋課程。
- 使用欄位名稱作為查詢參數
- 例如：/search?chinese_title=產業.+&english_title=...

## Query parameters

- `id` string — 課號
- `chinese_title` string — 課程中文名稱
- `english_title` string — 課程英文名稱
- `credit` string — 學分數
- `size_limit` string — 人限
- `freshman_reservation` string — 新生保留人數
- `object` string — 通識對象
- `ge_type` string — 通識類別
- `language` '中' | '英' — Course language options.
- `note` string — 備註
- `suspend` string — 停開註記
- `class_room_and_time` string — 教室與上課時間
- `teacher` string — 授課教師
- `prerequisite` string — 擋修說明
- `limit_note` string — 課程限制說明
- `expertise` string — 第一二專長對應
- `program` string — 學分學程對應
- `no_extra_selection` string — 不可加簽說明
- `required_optional_note` string — 必選修說明

## Response `200`

Successful Response

- CourseData[]
  - `id` string, required — 課號
  - `chinese_title` string, required — 課程中文名稱
  - `english_title` string, required — 課程英文名稱
  - `credit` string, required — 學分數
  - `size_limit` string, required — 人限
  - `freshman_reservation` string, required — 新生保留人數
  - `object` string, required — 通識對象
  - `ge_type` string, required — 通識類別
  - `language` '中' | '英', required — Course language options.
  - `note` string, required — 備註
  - `suspend` string, required — 停開註記
  - `class_room_and_time` string, required — 教室與上課時間
  - `teacher` string, required — 授課教師
  - `prerequisite` string, required — 擋修說明
  - `limit_note` string, required — 課程限制說明
  - `expertise` string, required — 第一二專長對應
  - `program` string, required — 學分學程對應
  - `no_extra_selection` string, required — 不可加簽說明
  - `required_optional_note` string, required — 必選修說明

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nthusa/apis/nthu-data-api.md) · [All operations](https://skmtc.net/nthusa/apis/nthu-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nthusa/nthu-data-api/versions/a7a2f39dbc76/schema)
