API AccessAccess dataset files directly from scripts, code, or AI agents.
Browse dataset files
Access dataset files directly from scripts, code, or AI agents.
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.
Start with these files — they give you everything you need to understand and access the dataset.
- 1. Fetch datapackage.json to inspect schema and resources
- 2. Download data resources listed in datapackage.json
- 3. Read README.md for full context
Data Views
Data Previews
household-income-us-historical
Schema
| name | type | description |
|---|---|---|
| Year | year | |
| Number (thousands) | number | |
| Lowest | number | Upper limit of each fifth (dollars) |
| Second | number | Upper limit of each fifth (dollars) |
| Third | number | Upper limit of each fifth (dollars) |
| Fourth | number | Upper limit of each fifth (dollars) |
| Top 5 percent | number | Lower limit of top 5 percent (dollars) |
Data Files
| File | Description | Size | Last modified | Download |
|---|---|---|---|---|
household-income-us-historical | 2016 dollars | 3.26 kB | 26 days ago | household-income-us-historical |
| Files | Size | Format | Created | Updated | License | Source |
|---|---|---|---|---|---|---|
| 1 | 3.26 kB | xls | about 1 year ago | United States Census Bureau |
Upper limits of annual incomes for each fifth and lower limit of income for top 5 percent of all housholds from 1967 to last year
Data
This dataset is acquired from U.S. Census Bureau, Current Population Survey, Annual Social and Economic Supplements. https://www2.census.gov/
Preparation
You will need Python 3.6 or greater and dataflows library to run the script
To update the data run the process script locally:
# Install dataflows
pip install dataflows
# Run the script
python houshold_us_flow.py
License
For information on confidentiality protection, sampling error, nonsampling error, and definitions, see //www2.census.gov/programs-surveys/cps/techdocs/cpsmar17.pdf