reviewed_by: rd: Ronny pm: James

立法院 API v2（tw.openfun~api~legislation）

版本：2026-05 最後更新：2026-05-21 維護：歐噴資料（data.openfun.tw） 授權：CC-BY 歐噴,立法院 原始資料授權：立法院網站資料開放宣告

資料集概述

本資料集為立法院議事、委員、法案、公報等完整資料的 RESTful API，由歐噴維護的 ly.govapi.tw 提供。資料直接來源於立法院官方開放資料平台（data.ly.gov.tw），涵蓋第 2 屆至今（第 11 屆）的立委、議案、法律、會議記錄、IVOD 影像等。

本 API 完全公開，不需要 Token 或帳號，適合查詢特定立委的提案記錄、追蹤法案的審議進度、取得特定委員會的開會紀錄、搜尋質詢資料等。

資料來源

項目 說明
原始來源 立法院開放資料平台（data.ly.gov.tw）
API 服務 由歐噴維護（ly.govapi.tw）
原始授權 立法院網站資料開放宣告
授權網址 https://www.ly.gov.tw/Pages/List.aspx?nodeid=10772
取得方式 直接對接立法院官方 API，即時同步
更新頻率 即時（與立法院官方資料同步）
涵蓋範圍 第 2 屆至今（部分資料類型從更早屆別起）

法源依據

立法院依《立法院職權行使法》、《立法院組織法》等相關法規，辦理議案審議、質詢、法律修訂等職務，並以立法院官方網站開放宣告提供資料開放使用。

本 API 資料直接來源於立法院對外公開的開放資料，依其開放宣告授權使用，再由歐噴以 CC-BY 授權公開提供。

資料規模（截至 2026-05-21）

資料類型 筆數 / 份數 涵蓋範圍
議案（bills） 144,379 筆 第 5–11 屆（第 11 屆 20,795 筆）
立法委員（legislators） 1,656 筆 第 2–11 屆
會議（meets） 7,913 筆 第 6–11 屆（第 11 屆 1,436 筆）
IVOD 影像記錄 100,048 筆 2005 年至今（第 6–11 屆）
公報（gazettes） 1,627 份 / 10,310 議程 民國 106–115 年
法律（laws） —（見 /laws） 現行法律與歷史版本
表決紀錄（votes） 6,145 筆 第 8–11 屆記名表決（截至 2026-06-18）

表決紀錄各屆筆數：第 8 屆 707、第 9 屆 3,326、第 10 屆 1,172、第 11 屆 940。僅收錄記名表決；黨團協商通過或口頭表決的議案不會出現在此資料中。

API 總覽

Base URL：https://v2.ly.govapi.tw 認證：不需要（完全公開） 分頁：?page=1&limit=20（預設 limit=20） 查詢參數語言：中文（不可翻譯成英文）

共 42 個端點，分 9 大類：

立委（Legislator）

端點 說明
GET /legislators 查立委列表；可篩 屆、黨籍、選區名稱、委員姓名、歷屆立法委員編號
GET /legislators/{term}/{name} 查特定立委（屆別＋姓名）的詳細資料
GET /legislators/{term}/{name}/propose_bills 查該立委提出的議案
GET /legislators/{term}/{name}/cosign_bills 查該立委連署的議案
GET /legislators/{term}/{name}/meets 查該立委出席的會議
GET /legislators/{term}/{name}/interpellations 查該立委的質詢記錄

立委資料包含：姓名、黨籍、選區、歷屆編號、委員會、任期、照片等。

議案（Bill）

端點 說明
GET /bills 查議案列表；可篩 屆、會期、議案類別、提案人、連署人、議案流程.狀態
GET /bills/{billNo} 查特定議案詳情（包含提案全文、審議流程）
GET /bills/{billNo}/related_bills 查相關議案
GET /bills/{billNo}/doc_html 取得議案文件 HTML
GET /bills/{billNo}/meets 查議案曾在哪些會議審議

議案類別常見值：法律案、預算案、條約案、決議案等。

議案流程.狀態為議案審議過程中出現過的狀態，查詢時字串需完全符合。

委員會（Committee）

端點 說明
GET /committees 查委員會列表
GET /committees/{comtCd} 查特定委員會詳情
GET /committees/{comtCd}/meets 查該委員會的會議記錄

常見委員會代號（整數）：15（內政）、35（外交及國防）、19（經濟）、20（財政）、22（教育及文化）、23（交通）、36（司法及法制）、26（社會福利及衛生環境）

公報（Gazette）

端點 說明
GET /gazettes 查公報列表
GET /gazettes/{id} 查特定公報
GET /gazettes/{id}/agendas 查該公報的議程列表
GET /gazette_agendas 查所有公報議程
GET /gazette_agendas/{id} 查特定公報議程

質詢（Interpellation）

端點 說明
GET /interpellations 查質詢記錄列表
GET /interpellations/{id} 查特定質詢記錄詳情

IVOD 影像（IVOD）

端點 說明
GET /ivods 查 IVOD 影像記錄列表
GET /ivods/{id} 查特定 IVOD 影像記錄詳情

IVOD（立法院影音隨選視訊）收錄院會、委員會的會議影像片段，涵蓋 2005 年至今，共 100,048 筆。

IVOD 單筆詳情（GET /ivods/{id}）包含 WhisperX AI 自動逐字稿（transcript.whisperx）。支援功能 欄位含 "ai-transcript" 的影像才有逐字稿。

取得發言文字有兩種管道，各有取捨：

公報逐字稿 IVOD AI 逐字稿
性質 官方記錄 AI 自動轉錄（非官方）
準確率 100% 約 80%，可能有辨識錯誤
取得時間 會後 2–3 週 幾乎即時

需要官方正確版本請等公報；需要即時參考可用 IVOD AI 逐字稿，但不適合作為正式引用依據。

法律（Law）

端點 說明
GET /laws 查法律列表；可篩 法律狀態（現行 / 廢止）、主管機關
GET /laws/{id} 查特定法律當前版本
GET /laws/{id}/progress 查法律的修法歷程摘要
GET /laws/{id}/bills 查與此法律相關的所有議案
GET /laws/{id}/versions 查法律的所有歷史版本
GET /law_versions 查所有法律版本
GET /law_versions/{id} 查特定法律版本的內容
GET /law_versions/{id}/contents 查特定法律版本的條文列表
GET /law_contents 查法律條文
GET /law_contents/{id} 查特定法律條文詳情

會議（Meet）

端點 說明
GET /meets 查會議列表；可篩 屆、會期、會議種類、日期、委員會代號、會議資料.出席委員
GET /meets/{id} 查特定會議詳情（含議程、出席委員等）
GET /meets/{id}/ivods 查該會議的 IVOD 影像記錄
GET /meets/{id}/bills 查該會議審議的議案
GET /meets/{id}/interpellations 查該會議的質詢記錄

會議代碼格式：{種類}-{屆}-{會期}-{委員會代號}-{次}，例如 委員會-11-5-35-13（院會無委員會代號欄，格式為 院會-{屆}-{會期}-{次}）。

表決（Vote）

端點 說明
GET /votes 查表決紀錄列表；可篩 屆、會議代碼、表決型態、投票委員、贊成、反對、棄權、公報文件代碼、表決時間
GET /votes/{id} 查特定表決詳情（id 為 表決代碼，例如 1150101_00002_55）
GET /votes/{id}/meets 查該筆表決所屬的會議

表決紀錄涵蓋第 8–11 屆的記名表決（roll call vote），共 6,145 筆，直接以結構化欄位提供每位委員的投票立場，不需再從公報全文解析。

單筆表決包含：屆、會議代碼、會議名稱、公報文件代碼、表決型態（如「記名表決」）、表決議題、表決時間、表決結果（含 出席人數、贊成人數、反對人數、棄權人數）、以及 投票委員／贊成／反對／棄權 四組委員姓名陣列。

僅收錄記名表決。黨團協商通過（完成協商）或以口頭、舉手方式表決的議案不會出現在此資料中。立法院院長主持院會、原則上不參與表決，故院長不會出現在投票名單。可用 投票委員= 篩出某委員所有參與過的表決，或用 贊成=／反對=／棄權= 篩出其特定立場的表決。

統計（Stat）

端點 說明
GET /stat 取得整體統計資料（各類資料筆數、最新時間戳等）

屆別與會期說明

台灣立法院目前為第 11 屆（2024 年 2 月起）。

屆 西元年 說明
11 2024– 現任（進行中）
10 2020–2024 —
9 2016–2020 —
8 2012–2016 —
7 2008–2012 —
6 2005–2008 —

每屆任期四年，每年兩個會期，一屆共 8 個會期：

會期值 期間 規律
1、3、5、7 2 月至 5 月底 奇數會期 = 上半年
2、4、6、8 9 月至 12 月底 偶數會期 = 下半年
0 不定期 臨時會 或 預備會議

立法院組織架構

資料來源：立法院全球資訊網－組織圖與行政組織

院長與副院長

立法院設院長、副院長各 1 人，由每屆立法委員於第 1 會期報到首日之預備會議中互選產生，任期與該屆委員同。院長擔任院會及全院委員會議之主席，綜理院務。

行政組織

秘書處、國際事務處、議事處、公報處、總務處、資訊處、法制局、預算中心、國會圖書館、中南部服務中心、議政博物館、人事處、主計處

委員會

常設委員會（8 個）：

中文名稱 委員會代號（整數）
內政委員會 15
外交及國防委員會 35
經濟委員會 19
財政委員會 20
教育及文化委員會 22
交通委員會 23
司法及法制委員會 36
社會福利及衛生環境委員會 26

特種委員會（4 個）：程序委員會、紀律委員會、修憲委員會、經費稽核委員會。

國會知識家：立法院基礎概念

資料來源：立法院官網國會知識家

會期

立法院會期每年兩次，委員每年 2 月 1 日、9 月 1 日起報到，由各黨團協商決定開議日期。必要時得依法延長會期；經總統咨請或立法委員 1/4 以上之請求，得開臨時會（API 中 會期=0）。

會議

院會：每週二、五舉行；每次 9–10 時為國是論壇；開議門檻委員總額 1/3。

委員會：各常設委員會設委員 13–15 人，置召集委員 2 人（委員互選）；開議門檻 1/3 委員出席。

全院委員會：由全體委員組成，行使同意任命權（司法院、考試院、監察院正副院長等）、審查緊急命令、審查總統副總統罷免或彈劾案等。

立法程序（三讀流程）

  1. 提案 → 送程序委員會排定議事日程（程序委員會 19 人，依黨團席次比例）
  2. 一讀（報告事項）→ 院會朗讀標題，交委員會審查或逕付二讀
  3. 委員會審查 → 可邀政府官員列席、舉辦公聽會、併案審查，完竣後議決是否提交黨團協商
  4. 二讀（討論事項）→ 逐條討論；可修正、重付審查、撤回；委員可提復議動議
  5. 三讀 → 僅得為文字修正；法律案、預算案須三讀；其餘議案僅需二讀
  6. 公布 → 咨請總統於 10 日內公布，或移請覆議

屆期不繼續原則：任期屆滿時，除預決算及請願案外，未議決之議案下屆不予繼續審議。

API 對應：/bills/{billNo} 的 議案流程 陣列記錄各審議狀態；議案流程.狀態 參數可精確篩選。

請願

人民請願文書由秘書處收文 → 程序委員會形式審查 → 交有關委員會審查 → 成為議案者進入討論事項。

API 對應：/bills?議案類別=請願

議事錄與公報的差異

立法院有兩種不同的「會議記錄」，常被混淆：

議事錄 公報（Gazette）
更新速度 會後約 1 週 會後約 2–3 週
API 位置 GET /meets/{id} 回應的 議事錄 欄位 GET /gazette/{編號}/agendas → GET /gazette_agenda_doc/{議程編號}/txt
內容 完整會議記錄，含結論、出席委員、列席官員 完整逐字稿（逐字記錄發言內容）
電子化起點 近年（逐步補齊） 民國 106 年（2017）起完整

查某場會議有沒有議事錄：呼叫 GET /meets/{id}，檢查回應 data.議事錄 是否非空。有值時含有 html_file（全文 HTML）和 txt_file（純文字）可直接取用。

「沒有公報」不等於「沒有議事錄」。議事錄（含結論）約會後 1 週公布；逐字稿公報則需 2–3 週。若只需確認會議結論，優先查議事錄。

資料特性與限制

  • 資料準確性：來源為立法院官方 API，偶有延遲更新或欄位空白屬上游問題
  • IVOD：2005 年起，第 6–8 屆覆蓋率較低
  • 公報：完整電子化記錄從民國 106 年（2017）起
  • 議案：第 5 屆起有較完整記錄
  • 表決紀錄：第 8 屆起有資料，僅含記名表決；協商通過、口頭表決的議案不在其中
  • 不帶屆別：回傳所有屆別資料，資料量龐大，建議加屆別過濾
  • 查詢參數為中文，URL encode 後 curl 自動處理

無法回答的問題

  • 立委財產申報（→ 財產申報資料集）
  • 政治獻金收支（→ tw.politics.campaign-finance）
  • 地方議會資料（本 API 只含中央立法院）
  • 即時直播（IVOD 非即時）

與其他資料來源的差異

資料來源 特點
本資料集（tw.openfun~api~legislation） 歐噴維護的統一 RESTful API，即時查詢、跨端點關聯；無需 Token
立法院原始開放資料（data.ly.gov.tw） 分散式，多種格式，需自行整合
立法院官方網站查詢 網頁介面，不支援程式化查詢
lawtrace.tw 法律修訂歷程視覺化（以本 API 為底層）
dataly.openfun.app 立法院資料視覺化平台（以本 API 為底層）

相關資料集

資料集 關聯說明
tw.gov.cec~ref~candidates 候選人資料，可對應立委的選舉背景
tw.gov.cec~ref~election-event 歷次投票事件，對照各屆立委選舉日期
tw.politics.campaign-finance 立委政治獻金申報
tw.politics.asset-declaration 公職人員財產申報，涵蓋立委
tw.gov.moi~ref~party 政黨資料，可對照 黨籍 欄位

AI 使用指引

AI agent 使用指引（含 API 端點清單、認證方式、常見查詢範例、注意事項）見 skill.md。

更新頻率與版本記錄

版本 更新日期 說明
2026-05 2026-05-21 初版建立
2026-05b 2026-05-25 新增「議事錄與公報的差異」說明
2026-06 2026-06-18 新增表決（Vote）端點與資料規模；對應 Dataly 投票記錄 collection