congress

CRAN status congress status badge Lifecycle: stable R-CMD-check Codecov test coverage

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: