The Legislator' Demographic Information and Background 提供委員基本資料
Source:R/legislators.R
get_legislators.RdProvides access to legislators' basic demographic and background information through the Legislative Yuan's V1 API interface.
Value
list contains:
query_timethe queried time
queried_termthe queried term
urlthe retrieved json url
variable_namesthe variables of the tibble dataframe
manual_infothe official manual from https://data.ly.gov.tw/getds.action?id=16, or use legisTaiwan::get_variable_info("get_legislators")
dataa tibble dataframe, whose variables include:
name委員姓名
ename委員姓名
sex性別
party黨籍
partyGroup黨團
committee委員會
onboardDate到職日(西元年)
degree學歷
experience經歷
picPath照片位址
leaveFlag離職日期(西元年)
leaveReason離職原因
Details
This function retrieves comprehensive data about legislators including their personal information, political background, and demographic details. The data is available starting from the 2nd legislative term.
get_legislators produces a list, which contains query_time,
queried_term, url, variable_names, manual_info and data.
Note
To retrieve the user manual and more information about variable of the data
frame, please use get_variable_info("get_legislators")
or visit the API manual at https://data.ly.gov.tw/getds.action?id=16.
提供委員基本資料，最早資料可追溯至第2屆。
See also
get_variable_info("get_legislators"), review_session_info()
Examples
## query the Executives' answered response by term and the session period.
## 輸入「立委屆期」與「會期」下載「行政院答復」
get_executive_response(term = 8, session_period = 1)
#>
#> Input Format Information:
#> ------------------------
#> Term: Must be numeric (e.g., 8, 9, 10, 11)
#> Session Period: Must be numeric (1-8)
#> ------------------------
#>
#> Downloading executive response data...
#>
|
| | 0%
|
|============= | 20%
|
|========================== | 40%
|
|====================================== | 60%
|
|=================================================== | 80%
|
|================================================================| 100%
#>
#>
#> ====== Retrieved Information ======
#> -----------------------------------
#> URL:
#> https://data.ly.gov.tw/odw/ID2Action.action?term=08&sessionPeriod=01&sessionTimes=&item=&fileType=json
#> Term: 08
#> Session Period: 1
#> Total Responses: 1065
#>
#> Session Distribution:
#> Session 01: 1065
#> ===================================
#> $title
#> [1] "Executive Response Records"
#>
#> $query_time
#> [1] "2025-01-20 20:13:01 UTC"
#>
#> $retrieved_number
#> [1] 1065
#>
#> $retrieved_term
#> [1] "08"
#>
#> $url
#> [1] "https://data.ly.gov.tw/odw/ID2Action.action?term=08&sessionPeriod=01&sessionTimes=&item=&fileType=json"
#>
#> $variable_names
#> [1] "term" "sessionPeriod" "sessionTimes" "meetingTimes"
#> [5] "eyNumber" "lyNumber" "subject" "content"
#> [9] "docUrl" "selectTerm"
#>
#> $manual_info
#> [1] "https://data.ly.gov.tw/getds.action?id=2"
#>
#> $data
#> # A tibble: 1,065 × 10
#> term sessionPeriod sessionTimes meetingTimes eyNumber lyNumber subject
#> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
#> 1 08 01 01 null （行政院函 中… （立法院函 編… （一八一）行…
#> 2 08 01 01 null （行政院函 中… （立法院函 編… （一八二）行…
#> 3 08 01 01 null （行政院函 中… （立法院函 編… （一八三）行…
#> 4 08 01 01 null （行政院函 中… （立法院函 編… （一八四）行…
#> 5 08 01 01 null （行政院函 中… （立法院函 編… （一八五）行…
#> 6 08 01 01 null （行政院函 中… （立法院函 編… （一八六）行…
#> 7 08 01 01 null （行政院函 中… （立法院函 編… （一八七）行…
#> 8 08 01 01 null （行政院函 中… （立法院函 編… （一八八）行…
#> 9 08 01 01 null （行政院函 中… （立法院函 編… （一八九）行…
#> 10 08 01 01 null （行政院函 中… （立法院函 編… （一九○）行…
#> # ℹ 1,055 more rows
#> # ℹ 3 more variables: content <chr>, docUrl <chr>, selectTerm <chr>
#>
# Get data for the 9th term
legislators_data <- get_legislators(term = 9)
#>
#> Input Format Information:
#> ------------------------
#> Term: Must be numeric (e.g., 8, 9, 10)
#> ------------------------
#>
#> Downloading legislators data...
#>
|
| | 0%
|
|============= | 20%
|
|========================== | 40%
|
|====================================== | 60%
|
|=================================================== | 80%
|
|================================================================| 100%
#>
#>
#> ====== Retrieved Information ======
#> -----------------------------------
#> URL: https://data.ly.gov.tw/odw/ID16Action.action?name=&sex=&party=&partyGroup=&areaName=&term=09=&fileType=json
#> Term: 9
#> Total Legislators: 128
#> -----------------------------------
#> Party Distribution:
#> 中國國民黨: 40
#> 時代力量: 4
#> 民主進步黨: 77
#> 無黨團結聯盟: 1
#> 無黨籍: 3
#> 親民黨: 3
#> ===================================
legislators_data
#> $title
#> [1] "Legislator's Demographic Information"
#>
#> $query_time
#> [1] "2025-01-20 20:13:03 UTC"
#>
#> $queried_term
#> [1] "9"
#>
#> $url
#> [1] "https://data.ly.gov.tw/odw/ID16Action.action?name=&sex=&party=&partyGroup=&areaName=&term=09=&fileType=json"
#>
#> $total_legislators
#> [1] 128
#>
#> $party_distribution
#>
#> 中國國民黨 時代力量 民主進步黨 無黨團結聯盟 無黨籍
#> 40 4 77 1 3
#> 親民黨
#> 3
#>
#> $variable_names
#> [1] "term" "name" "ename" "sex" "party"
#> [6] "partyGroup" "areaName" "committee" "onboardDate" "degree"
#> [11] "experience" "picUrl" "leaveFlag" "leaveDate" "leaveReason"
#>
#> $manual_info
#> [1] "https://data.ly.gov.tw/getds.action?id=16"
#>
#> $data
#> # A tibble: 128 × 15
#> term name ename sex party partyGroup areaName committee onboardDate
#> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
#> 1 09 王金平…… Wang… 男 中國國民… 中國國民黨 全國不分區及僑… 第9屆第1會期：… 2016/02/01
#> 2 09 王育敏…… Wang… 女 中國國民… 中國國民黨 全國不分區及僑… 第9屆第1會期：… 2016/02/01
#> 3 09 王定宇…… Wang… 男 民主進步… 民主進步黨 臺南市第5選舉… 第9屆第1會期：… 2016/02/01
#> 4 09 王惠美…… Wang… 女 中國國民… 中國國民黨 彰化縣第1選舉… 第9屆第1會期：… 2016/02/01
#> 5 09 王榮璋…… Wang… 男 民主進步… 民主進步黨 全國不分區及僑… 第9屆第1會期：… 2016/02/01
#> 6 09 孔文吉…… Kung… 男 中國國民… 中國國民黨 山地原住民…… 第9屆第1會期：… 2016/02/01
#> 7 09 尤美女…… Yu M… 女 民主進步… 民主進步黨 全國不分區及僑… 第9屆第1會期：… 2016/02/01
#> 8 09 江永昌…… Chia… 男 民主進步… 民主進步黨 新北市第8選舉… 第9屆第1會期：… 2016/02/01
#> 9 09 江啟臣…… Chia… 男 中國國民… 中國國民黨 臺中市第8選舉… 第9屆第1會期：… 2016/02/01
#> 10 09 何欣純…… Ho H… 女 民主進步… 民主進步黨 臺中市第7選舉… 第9屆第1會期：… 2016/02/01
#> # ℹ 118 more rows
#> # ℹ 6 more variables: degree <chr>, experience <chr>, picUrl <chr>,
#> # leaveFlag <chr>, leaveDate <chr>, leaveReason <chr>
#>