get_speech_video: The Video Information of Meetings and Committees...

In yl17124/legisTaiwan: An Interface to Access Taiwan Legislative API in R

The Video Information of Meetings and Committees 院會及委員會之委員發言片段相關影片資訊

Description

Retrieves video records and information of legislative meetings and committee sessions, including speech segments, meeting details, and video URLs. Data is available in both JSON and CSV formats from the 9th legislative term onwards.

Usage

get_speech_video(
  term = NULL,
  session_period = NULL,
  start_date = NULL,
  end_date = NULL,
  verbose = TRUE,
  format = "json"
)

Arguments

term	numeric or NULL. Legislative term number (e.g., 10). Data is available from the 9th term onwards. Default is NULL.
session_period	numeric or NULL. Session period number (1-8). Default is NULL.
start_date	character. Must be formatted in ROC calendar with forward slashes between year, month and day, e.g., "110/10/01".
end_date	character. Must be formatted in ROC calendar with forward slashes between year, month and day, e.g., "110/10/30".
verbose	logical. Whether to display download progress and detailed information. Default is TRUE.
format	character. Data format to retrieve, either "json" or "csv". Default is "json".

Details

The function retrieves video information from legislative meetings and committee sessions. Data is available from the 9th legislative term onwards (2016/民國105年). The date parameters must use the ROC calendar format with forward slashes. Data can be retrieved in either JSON or CSV format.

Value

A list containing:

title

speech video records

query_time

query timestamp

retrieved_number

number of videos retrieved

term

queried legislative term

session_period

queried session period

start_date

start date in ROC calendar

end_date

end date in ROC calendar

format

data format ("json" or "csv")

url

retrieved API URL

variable_names

variables in the tibble dataframe

manual_info

official manual URL

data

a tibble dataframe containing:

term

屆別

sessionPeriod

會期

meetingDate

會議日期(西元年)

meetingTime

會議時間

meetingTypeName

主辦單位

meetingName

會議名稱

meetingContent

會議事由

legislatorName

委員姓名

areaName

選區名稱

speechStartTime

委員發言時間起

speechEndTime

委員發言時間迄

speechRecordUrl

發言紀錄網址

videoLength

影片長度

videoUrl

影片網址

selectTerm

屆別期別篩選條件

Note

For more details about the data variables and API information, use get_variable_info("get_speech_video") or visit: https://data.ly.gov.tw/getds.action?id=148

會議類:提供立法院院會及委員會之委員發言片段相關影片資訊 (自第9屆第1會期起)。

See Also

• get_variable_info("get_speech_video")

• Example API URL: https://data.ly.gov.tw/odw/ID148Action.action?term=10&sessionPeriod=4&meetingDateS=110/10/01&meetingDateE=110/10/30&meetingTime=&legislatorName=&fileType=csv

Examples

## Not run: 
# Query video information in JSON format
videos <- get_speech_video(
  term = 10,
  session_period = 4,
  start_date = "110/10/01",
  end_date = "110/10/30"
)

# Query in CSV format
videos_csv <- get_speech_video(
  term = 10,
  session_period = 4,
  start_date = "110/10/01",
  end_date = "110/10/30",
  format = "csv"
)

# Query without specifying term/session
videos <- get_speech_video(
  start_date = "110/10/01",
  end_date = "110/10/30"
)

## End(Not run)

yl17124/legisTaiwan documentation built on June 15, 2025, 12:59 a.m.