CoolFace
Datasetpublic

hyperdemocracy/usc-billstatus

Dataset Description This dataset is part of a family of datasets that provide convenient access to congressional data from the US Government Publishing Office via the GovInfo Bulk Data Repository. GovInfo provides bulk data in xml format. The raw xml files were downloaded using the congress repo. Further processing was done using the legisplain legisplain repo. Hyperdemocracy Datasets usc-billstatus (metadata on each bill) usc-textversion (different text versions… See the full description on the dataset page: https://huggingface.co/datasets/hyperdemocracy/usc-billstatus.

sourceHugging Facemitupdated 1y agoView on Hugging Face
0likes60downloads
Dataset Card

Dataset Description

This dataset is part of a family of datasets that provide convenient access to congressional data from the US Government Publishing Office via the GovInfo Bulk Data Repository. GovInfo provides bulk data in xml format. The raw xml files were downloaded using the congress repo. Further processing was done using the legisplain legisplain repo.

Hyperdemocracy Datasets

BILLSTATUS (metadata for congresses 108-119)

  • https://www.govinfo.gov/bulkdata/BILLSTATUS
  • https://github.com/usgpo/bill-status/blob/main/BILLSTATUS-XMLUserUser-Guide.md
  • https://github.com/usgpo/bulk-data/blob/main/Bills-XML-User-Guide.md

These xml files contain metadata about each bill and pointers to different xml files that contain various text versions of each bill.

Column Descriptions

Hyperdemocracy column descriptions.

ColumnDescription
legis_ida unique ID for each bill ({congress_num}-{legis_type}-{legis_num})
congress_numthe congress number for the bill
legis_typeone of [hr, hres, hconres, hjres, s, sres, sconres, sjres] (see govinfo - types of legislation)
legis_numbills in each congress and of each type get an incrementing number as part of their ID
bulk_pathXML file path during bulk download
lastmodlastmod date during bulk download
bs_xmlcontents of billstatus XML file
bs_jsonbillstatus XML parsed into JSON
*all top level keys of the bs_json object also get their own column

See the BILLSTATUS XML User Guide for descriptions of the other columns.

Examples

The dataset is broken into splits (one split per congress number).

python
from datasets import load_dataset

# load each split into a `DatasetDict` keyed on congress number
dsd = load_dataset(path="hyperdemocracy/usc-billstatus")

# load a single congress number into a `Dataset`
ds = load_dataset(path="hyperdemocracy/usc-billstatus", split=117)

# load all congress numbers into a single `Dataset`
ds = load_dataset(path="hyperdemocracy/usc-billstatus", split="all")

Congress Number to Date Mapping

Congress NumberYearsMetadataText
1192025-2026TrueTrue
1182023-2024TrueTrue
1172021-2022TrueTrue
1162019-2020TrueTrue
1152017-2018TrueTrue
1142015-2016TrueTrue
1132013-2014TrueTrue
1122011-2012TrueFalse
1112009-2010TrueFalse
1102007-2008TrueFalse
1092005-2006TrueFalse
1082003-2004TrueFalse