關鍵字 / Keywords: 立法委員 立委 問政 提案 連署 質詢 發言 表決 出席 出席率 修法 legislator lawmaker profile bills votes speeches Taiwan Legislative Yuan
【Region】Taiwan (ROC · 中華民國) 立法院。
【何時用】想知道某位立法委員曾經提過哪些法案、連署了什麼、質詢與發言紀錄、院會表決怎麼投、
院會出席率,或主提案修了哪些法律;
或想知道某一屆有哪些立委、共幾位(只給 term,例如 11 → 該屆委員名單與總數)。
預設回「摘要」:每個區塊的總筆數 + 最新 3 筆 + next_cursor。要看某區塊的完整清單,
sections 只給那一個區塊,再用 limit_per_section / cursor 翻頁。
Args:
name: 委員姓名(與 legislator_id 擇一)。原住民委員可只給漢名(「伍麗華」會對到名錄的完整名)。
同名或對到多位 → 回 candidates,不會猜;查無 → 回 did_you_mean。
legislator_id: 上一次回傳的 legislator.id(或 candidates[].id);給了就不比對姓名。
term: 屆別;不給 = 現任屆(現任屆查無時改查歷屆)。只給 term、不給 name / legislator_id →
列表模式:回 {term, total, legislators: [{id, name, party, area, left}], next_cursor}
(一頁 limit_per_section 位;名單含已離職、遞補)。
sections: 區塊:bills(提案 / 連署)、interpellations(質詢)、speeches(發言)、
votes(院會表決)、attendance(院會 / 全院委員會出席,含出席率 summary)、
law_proposals(主提案的修法,可接 tw_ly_law_history(code=law_code))。不給 = 摘要模式。
date_from / date_to: 西元 YYYY-MM-DD(質詢區塊沒有日期,不套用)。
limit_per_section: 1–50,單一區塊模式才生效。
cursor: 上一次回傳的 next_cursor;要搭配同一個區塊與同樣的條件。
Returns:
{legislator: {id, name, term, party, area, committees, onboard_date, left, leave_date},
coverage: {區塊: {source, from?, to?, upstream_modified?, note?, license}},
bills / interpellations / speeches / votes / law_proposals: {total, items, next_cursor},
attendance: {summary: {attended, expected, rate_pct, unit} | null, total, items, next_cursor}}
區塊資料尚未發布時該區塊回 {total: null, available: false, message}。
coverage 說明各區塊的資料範圍:0 筆要對照 coverage 解讀,不代表委員沒做過。