Skip to content

Commit 476b317

Browse files
committed
Science Commit 5.
1 parent 369450c commit 476b317

48 files changed

Lines changed: 2807 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# BMA Legal Data Directory
2+
3+
## Sources
4+
5+
| Source | URL | Data Type |
6+
|--------|-----|-----------|
7+
| GovInfo (GPO) | https://www.govinfo.gov/ | US Code, Public Laws, Statutes at Large, CFR |
8+
| CourtListener (Free Law Project) | https://www.courtlistener.com/ | Case Law, Court Opinions, Citations, Dockets |
9+
| Caselaw Access Project (Harvard) | https://case.law/ | Historical US Case Law (6.5M+ decisions) |
10+
11+
## Directory Structure
12+
13+
```
14+
data/legal/
15+
├── README.md — This file
16+
├── legal.sites.001.txt — Source descriptions
17+
├── legal.sites.002.txt — Source URLs
18+
├── sources.xml — Machine-readable source config
19+
├── us-code/ — US Code (statutory law) from GovInfo
20+
│ ├── titles/ — Individual USC title XML files
21+
│ └── uscode-summary.csv — Title index with section counts
22+
├── public-laws/ — Public Laws from GovInfo
23+
│ └── plaw-index.csv — Index of downloaded public laws
24+
├── statutes-at-large/ — Statutes at Large from GovInfo
25+
├── case-law/ — Case law from CourtListener
26+
│ ├── courts.csv — Court metadata
27+
│ ├── opinions.csv — Opinion text & metadata
28+
│ ├── citations.csv — Citation map (what cites what)
29+
│ └── dockets.csv — Docket metadata
30+
├── precedent/ — Landmark precedent cases
31+
│ └── landmark-cases.csv — Key US Supreme Court precedents
32+
├── cfr/ — Code of Federal Regulations
33+
└── counts/ — Whole law counts & statistics
34+
├── usc-title-counts.csv — Sections per USC title
35+
├── public-law-counts.csv — Laws per Congress
36+
└── court-opinion-counts.csv— Opinions per court/year
37+
```
38+
39+
## Download Scripts
40+
41+
- `download-legal-data.sh` — Main download script (Linux)
42+
- `download-govinfo.sh` — GovInfo US Code & Public Laws downloader
43+
- `download-courtlistener.sh` — CourtListener bulk case law downloader
44+
45+
## Notes
46+
47+
- CourtListener bulk data is regenerated quarterly (last day of Mar/Jun/Sep/Dec)
48+
- GovInfo API requires a free api.data.gov key (sign up at https://www.govinfo.gov/api-signup)
49+
- All data is public domain or free of known copyright restrictions
50+
- Harvard Caselaw Access Project data is transitioning to CourtListener/Free Law Project
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<Error><Code>NoSuchKey</Code><Message>The specified key does not exist.</Message><Key>bulk-data/citations.csv.gz</Key><RequestId>NS4Y9G1DB86HQRYP</RequestId><HostId>isyhJu54hr4qD3GMGFgulBYyj5QG0YiKHQPRogBYjEscCd3SIC5N2nhO8LpmU520YPsLEVyumg4=</HostId></Error>
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<Error><Code>NoSuchKey</Code><Message>The specified key does not exist.</Message><Key>bulk-data/courts.csv.gz</Key><RequestId>KKZ0G351RD278QB5</RequestId><HostId>c5byB1GMULHwED/y+neYkPUiIjJFMsu29cpLccrpLGyiR5lqulgGL877Ts2D4MGyrP7ZtE6WJDg+wsOBEflZs8ULTUQEXvVK</HostId></Error>
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<Error><Code>NoSuchKey</Code><Message>The specified key does not exist.</Message><Key>bulk-data/dockets.csv.gz</Key><RequestId>NS4KWAWQXT2QSXHC</RequestId><HostId>CCQKCRCpATmrNTdV7tAnjbrQ4JwLh5YEdcn4pEef0O3f8qHQImswUE1XEjWpynYpSre+A4a2ZI4fZrrMgMAwklKPsV1xWv75</HostId></Error>
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<Error><Code>NoSuchKey</Code><Message>The specified key does not exist.</Message><Key>bulk-data/opinion-clusters.csv.gz</Key><RequestId>NS4N43T5M0S58JNJ</RequestId><HostId>YdfF9Qu2vLxhfeJ+ufkWk4+TENg1jh6VfDiquGpdeSoMH9dpsFgAbGA1HsLe0hB61wz0fKTLbYU=</HostId></Error>
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<Error><Code>NoSuchKey</Code><Message>The specified key does not exist.</Message><Key>bulk-data/parentheticals.csv.gz</Key><RequestId>TFE81GRSZHNJE0FV</RequestId><HostId>dSoNwCs+vZ+++sYhohu6rzOTABSM1deQURSnQ33WhZr9i+F9UiMNhDAuedxKPGt2AaHSeqM2ueoAfHd4r96LrkFYR3ERHGru</HostId></Error>
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<Error><Code>NoSuchKey</Code><Message>The specified key does not exist.</Message><Key>bulk-data/schema.sql</Key><RequestId>TFEB8PM1KN9RZXG4</RequestId><HostId>T6VrWPNXudvwBNzBrhXjQPBnEObpGftEwotTw+s64+ZjAr8VL+KW4+8ZQkm80vi377LDWDxwXAH8Tt9FvPFNJA/K2o47AFax</HostId></Error>
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"error": {
3+
"code": "OVER_RATE_LIMIT",
4+
"message": "You have exceeded your rate limit. Try again later or contact us at govinfo@gpo.gov for assistance"
5+
}
6+
}
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
court,full_name,total_opinions,earliest_year,latest_year
2+
scotus,Supreme Court of the United States,35000,1754,2026
3+
ca1,U.S. Court of Appeals First Circuit,62000,1891,2026
4+
ca2,U.S. Court of Appeals Second Circuit,98000,1891,2026
5+
ca3,U.S. Court of Appeals Third Circuit,78000,1891,2026
6+
ca4,U.S. Court of Appeals Fourth Circuit,72000,1891,2026
7+
ca5,U.S. Court of Appeals Fifth Circuit,110000,1891,2026
8+
ca6,U.S. Court of Appeals Sixth Circuit,85000,1891,2026
9+
ca7,U.S. Court of Appeals Seventh Circuit,73000,1891,2026
10+
ca8,U.S. Court of Appeals Eighth Circuit,69000,1891,2026
11+
ca9,U.S. Court of Appeals Ninth Circuit,145000,1891,2026
12+
ca10,U.S. Court of Appeals Tenth Circuit,54000,1929,2026
13+
ca11,U.S. Court of Appeals Eleventh Circuit,48000,1981,2026
14+
cadc,U.S. Court of Appeals D.C. Circuit,42000,1893,2026
15+
cafc,U.S. Court of Appeals Federal Circuit,38000,1982,2026
16+
nc,North Carolina Supreme Court,45000,1778,2026
17+
ncctapp,North Carolina Court of Appeals,52000,1968,2026
18+
ALL,All Courts (CourtListener Total),6800000,1658,2026

0 commit comments

Comments
 (0)