Data Access
There are many different ways to download or access OEPS data, find the one that works best for you. You may also be interested in our code resources page with notebooks and tutorials.
Direct Download
CSVs & Data Dictionaries
Not sure where to start? These data dictionaries provide a comprehensive overview of what variables are available for each geography—State (S), County (C), Census Tract (T), and Zip Code Tabulation Area (Z).
OEPS datasets are merged into single CSVs, one per geography (State, County, Tract, ZCTA) per year (1980, 1990, etc.). Each CSV can be joined to an appropriate geometry file using the HEROP_ID field.
State
Year | File |
---|---|
1980 | state-1980.csv |
1990 | state-1990.csv |
2000 | state-2000.csv |
2010 | state-2010.csv |
2013 | state-2013.csv |
2014 | state-2014.csv |
2015 | state-2015.csv |
2016 | state-2016.csv |
2017 | state-2017.csv |
2018 | state-2018.csv |
2019 | state-2019.csv |
2020 | state-2020.csv |
2021 | state-2021.csv |
2022 | state-2022.csv |
2023 | state-2023.csv |
2025 | state-2025.csv |
County
Year | File |
---|---|
1980 | county-1980.csv |
1990 | county-1990.csv |
2000 | county-2000.csv |
2010 | county-2010.csv |
2014 | county-2014.csv |
2015 | county-2015.csv |
2016 | county-2016.csv |
2017 | county-2017.csv |
2018 | county-2018.csv |
2019 | county-2019.csv |
2020 | county-2020.csv |
2021 | county-2021.csv |
2022 | county-2022.csv |
2023 | county-2023.csv |
2025 | county-2025.csv |
Tract
Year | File |
---|---|
1980 | tract-1980.csv |
1990 | tract-1990.csv |
2000 | tract-2000.csv |
2010 | tract-2010.csv |
2014 | tract-2014.csv |
2018 | tract-2018.csv |
2019 | tract-2019.csv |
2020 | tract-2020.csv |
2021 | tract-2021.csv |
2022 | tract-2022.csv |
2023 | tract-2023.csv |
2025 | tract-2025.csv |
Zip Code Tabulation Area (ZCTA)
Year | File |
---|---|
2018 | zcta-2018.csv |
2019 | zcta-2019.csv |
2020 | zcta-2020.csv |
2021 | zcta-2021.csv |
2022 | zcta-2022.csv |
2023 | zcta-2023.csv |
2025 | zcta-2025.csv |
Geometry Files
For spatial analysis we provide our geographic datasets generated from the US Census Bureau's Cartographic Boundary files (500k scale). We provide the following formats: Shapefile, GeoJSON, or PMTiles.
Joining to geometry files:
- Use 2010 geometry files when joining to any OEPS data from 1980, 1990, 2000, or 2010. Use the 2018 geometry files for any later datasets up to 2020.
- Use 2020 geometry files for all geographies and years 2020 and beyond.
- In Connecticut: For county and tract data from 2022 or later you must use 2022 geographies because county (and therefore tract) FIPS ids changed between 2021 and 2022. To translate 2022 tracts back to 2020 geometries, you can use these crosswalks from CT Data Collaborative.
Frictionless Data Package
We provide a single data package with all CSV and Shapefile assets which is structured to match the Data Package specification published by Frictionless Data.
Programmatic Access
oepsData — R Package
We maintain a small R package called oepsData. This package is the best way for researchers who use R to load and analyze OEPS data directly, without the need to download CSVs or Shapefiles and worry about joins.
- Documentation: Learn how to install and use the package.
- Usage examples: Within the package docs we have a few examples of what it looks like to load and use OEPS data.
- GitHub: Use the GitHub repo to report issues you have with the package, or suggest new features or datasets.
Current release: v0.1
Google BigQuery
We have loaded the OEPS data warehouse into Google BigQuery, a data storage platgorm that provides the ability for researchers to run SQL queries (including spatial queries) to retrieve or perform analysis on specific data subsets. Google publishes many different clients through which you can access a BigQuery database, and for R users there is bigrquery. Here's how to get started:
- Introduction to OEPS in Google BigQuery: The oepsData documentation includes a detailed overview that is relevant no matter what client you use.
- Setting up BigQuery in R: The oepsData documentation also has a walkthrough guide illustrating how R users can connect directly to our data in BigQuery.
- Database Table Reference: Full reference document, provides the project id and the names of all tables and columns.