Description
Access the Congress.gov API.
Description
Download and read data on United States congressional proceedings. Data is read from the Library of Congress's Congress.gov Application Programming Interface (<https://github.com/LibraryOfCongress/api.congress.gov/>). Functions exist for all version 3 endpoints, including for bills, amendments, congresses, summaries, members, reports, communications, nominations, and treaties.
README.md
congress 
congress provides a mostly tidy interface to the Congress.gov API, available at https://github.com/LibraryOfCongress/api.congress.gov/. It provides a simple R interface for downloading and working with actions, bills, nominations, and more from Congress.
Installation
You can install the stable version of congress from CRAN with:
install.packages('congress')
You can install the development version of congress from GitHub with:
# install.packages('devtools')
devtools::install_github('christopherkenny/congress')
Example
To get the most recent nominations, we can use the cong_nomination() function. By default, it gets the most recent 20. We request here, the most recent 10.
library(congress)
cong_nomination(limit = 10)
#> # A tibble: 10 × 12
#> citation congress description latest_action_action…¹ latest_action_text
#> <chr> <chr> <chr> <date> <chr>
#> 1 PN1025 118 Jennifer L. Fain… 2023-12-20 Confirmed by the …
#> 2 PN871 118 Rion J. Ramirez,… 2023-12-20 Confirmed by the …
#> 3 PN832 118 Tadd M. Johnson,… 2023-12-20 Confirmed by the …
#> 4 PN1020 118 John A. Kazen, o… 2023-12-20 By unanimous cons…
#> 5 PN548 118 Tobin John Bradl… 2023-12-20 Confirmed by the …
#> 6 PN1044 118 Spencer Bachus I… 2023-12-20 Confirmed by the …
#> 7 PN918 118 William Brodsky,… 2023-12-20 Confirmed by the …
#> 8 PN742 118 David E. White, … 2023-12-20 Confirmed by the …
#> 9 PN805 118 Bradford Pentony… 2023-12-20 Confirmed by the …
#> 10 PN831 118 Claudia Slacik, … 2023-12-20 Confirmed by the …
#> # ℹ abbreviated name: ¹latest_action_action_date
#> # ℹ 7 more variables: nomination_type_is_civilian <chr>, number <chr>,
#> # organization <chr>, part_number <chr>, received_date <date>,
#> # update_date <dttm>, url <chr>
You can request up to 250 results, using limit. Once a request has been made, you can request the next set by using the offset argument:
cong_nomination(limit = 10, offset = 10)
#> # A tibble: 10 × 13
#> citation congress description latest_action_action…¹ latest_action_text
#> <chr> <chr> <chr> <date> <chr>
#> 1 PN805 118 Bradford Pentony… 2023-12-20 Confirmed by the …
#> 2 PN1045 118 Tanya F. Otsuka,… 2023-12-20 Confirmed by the …
#> 3 PN36 118 Elizabeth H. Ric… 2023-12-19 Confirmed by the …
#> 4 PN365-2 118 <NA> 2023-12-19 Confirmed by the …
#> 5 PN196-4 118 <NA> 2023-12-13 Placed on Senate …
#> 6 PN157 118 Jose Javier Rodr… 2023-12-18 By unanimous cons…
#> 7 PN884 118 <NA> 2023-12-19 Confirmed by the …
#> 8 PN883 118 <NA> 2023-12-19 Confirmed by the …
#> 9 PN376 118 S. Kato Crews, o… 2023-12-19 By unanimous cons…
#> 10 PN888 118 <NA> 2023-12-19 Confirmed by the …
#> # ℹ abbreviated name: ¹latest_action_action_date
#> # ℹ 8 more variables: nomination_type_is_civilian <chr>, number <chr>,
#> # organization <chr>, part_number <chr>, received_date <date>,
#> # update_date <dttm>, url <chr>, nomination_type_is_military <chr>
You can also request the next set using the cong_request_next() function:
cong_nomination(limit = 10) |>
cong_request_next()
#> # A tibble: 20 × 13
#> citation congress description latest_action_action…¹ latest_action_text
#> <chr> <chr> <chr> <date> <chr>
#> 1 PN1025 118 Jennifer L. Fain… 2023-12-20 Confirmed by the …
#> 2 PN871 118 Rion J. Ramirez,… 2023-12-20 Confirmed by the …
#> 3 PN832 118 Tadd M. Johnson,… 2023-12-20 Confirmed by the …
#> 4 PN1020 118 John A. Kazen, o… 2023-12-20 By unanimous cons…
#> 5 PN548 118 Tobin John Bradl… 2023-12-20 Confirmed by the …
#> 6 PN1044 118 Spencer Bachus I… 2023-12-20 Confirmed by the …
#> 7 PN918 118 William Brodsky,… 2023-12-20 Confirmed by the …
#> 8 PN742 118 David E. White, … 2023-12-20 Confirmed by the …
#> 9 PN805 118 Bradford Pentony… 2023-12-20 Confirmed by the …
#> 10 PN831 118 Claudia Slacik, … 2023-12-20 Confirmed by the …
#> 11 PN805 118 Bradford Pentony… 2023-12-20 Confirmed by the …
#> 12 PN1045 118 Tanya F. Otsuka,… 2023-12-20 Confirmed by the …
#> 13 PN36 118 Elizabeth H. Ric… 2023-12-19 Confirmed by the …
#> 14 PN365-2 118 <NA> 2023-12-19 Confirmed by the …
#> 15 PN196-4 118 <NA> 2023-12-13 Placed on Senate …
#> 16 PN157 118 Jose Javier Rodr… 2023-12-18 By unanimous cons…
#> 17 PN884 118 <NA> 2023-12-19 Confirmed by the …
#> 18 PN883 118 <NA> 2023-12-19 Confirmed by the …
#> 19 PN376 118 S. Kato Crews, o… 2023-12-19 By unanimous cons…
#> 20 PN888 118 <NA> 2023-12-19 Confirmed by the …
#> # ℹ abbreviated name: ¹latest_action_action_date
#> # ℹ 8 more variables: nomination_type_is_civilian <chr>, number <chr>,
#> # organization <chr>, part_number <chr>, received_date <date>,
#> # update_date <dttm>, url <chr>, nomination_type_is_military <chr>
Supported Endpoints:
This package is designed for v3 of the Congress.gov API. It currently supports the following endpoints:
- bills with
cong_bill() - amendments with
cong_amendment() - summaries with
cong_summaries() - congresses with
cong_congress() - members with
cong_member() - committees with
cong_committee() - committee reports with
cong_committee_report() - committee prints with
cong_committee_print() - committee meetings with
cong_committee_meeting() - Congressional Records with
cong_record() - Daily Congressional Records with
cong_daily_record() - Bound Congressional Records with
cong_bound_record() - House communications with
cong_house_communication() - Senate communications with
cong_senate_communication() - nominations with
cong_nomination() - treaties with
cong_treaty() - hearings with
cong_hearing()