Get Bill by legislator

Retrieves comprehensive information for a specific legislator from the Legislative Yuan API. This includes personal details, committee assignments, educational background, and work experience.

Usage

get_ly_legislator_bills(term, name, page = 1, limit = 20, show_progress = TRUE)

Arguments

term: integer. Required. The legislative term number (e.g., 9)
name: string. Required. The legislator's name in Chinese (e.g., the legislator romanized as "Wang Jin-pyng")
page: integer. Page number for pagination (default: 1)
limit: integer. Number of records per page (default: 20)
show_progress: logical. Whether to display progress information (default: TRUE)

Value

A list containing two components:

metadata

A list containing pagination information:

total: Total number of bills
total_page: Total number of pages
current_page: Current page number
per_page: Number of records per page

bills

A data frame containing bill information:

billNo: Bill number
billName: Bill name (raw column name is a Chinese label)
billOrg: Proposing unit/legislator (raw column name is a Chinese label)
billStatus: Bill status (raw column name is a Chinese label)
billType: Bill type (raw column name is a Chinese label)
billSource: Bill source (raw column name is a Chinese label)
meet_id: Meeting ID
session: Session number (raw column name is a Chinese label)
referenceNo: Reference number (raw column name is a Chinese label)
proposalNo: Proposal number (raw column name is a Chinese label)
term: Legislative term (raw column name is a Chinese label)
mtime: Last modified time

Details

Get Bill by legislator

API Details

The function accesses the Legislative Yuan's open data API. The API endpoint format is: https://ly.govapi.tw/legislator/{term}/{name}/propose_bill

Data Usage

The returned data can be used for:

Analysis: Analyzing legislator's bill proposal patterns
Tracking: Tracking bill status and progress
Research: Studying legislative priorities
Policy: Conducting policy research

Examples

if (FALSE) { # \dontrun{
# Get bills for a specific legislator
bills <- get_ly_legislator_bills(
  term = 9,
  name = "Wang Jin-pyng",  # a legislator's Chinese name goes here
  limit = 10
)

# Get second page of bills
bills_page2 <- get_ly_legislator_bills(
  term = 9,
  name = "Wang Jin-pyng",  # a legislator's Chinese name goes here
  page = 2,
  limit = 20
)

# Display summary statistics
cat(sprintf(
  "Total Bills: %d\nCurrent Page: %d\nBills per page: %d\n",
  bills$metadata$total,
  bills$metadata$current_page,
  bills$metadata$per_page
))
} # }