API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
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
Comparison of upper limit of each fifth and lower limit of top 5 percent (2016 dollars)
Data Files
Explore with AIhousehold-income-us-historical
| Field | 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) |
Download
Download CSVAbout
- 2016 dollars
- Last updated
- 9 February 2026
- Total rows
- ...
- Format
- CSV
- File size
- 3.26 kB
About this dataset
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