Now you can request additional data and/or customized columns!

Try It Now!

Income Limits for Each Fifth and Top 5 Percent of All Households: 1967 to 2016

Certified

core

Files Size Format Created Updated License Source
2 47kB csv zip 6 years ago 4 years ago Open Data Commons Public Domain Dedication and License v1.0 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 read more
Download Developers

Data Files

Download files in this dataset

File Description Size Last changed Download
household-income-us-historical 5kB csv (5kB) , json (10kB)
household-income-us-historical_zip Compressed versions of dataset. Includes normalized CSV and JSON data with original data and datapackage.json. 7kB zip (7kB)

household-income-us-historical  

Signup to Premium Service for additional or customised data - Get Started

This is a preview version. There might be more data in the original version.

Field information

Field Name Order Type (Format) Description
Year 1 year (default)
Number (thousands) 2 number (default)
Lowest 3 number (default)
Second 4 number (default)
Third 5 number (default)
Fourth 6 number (default)
Top 5 percent 7 number (default)

Integrate this dataset into your favourite tool

Use our data-cli tool designed for data wranglers:

data get https://datahub.io/core/household-income-us-historical
data info core/household-income-us-historical
tree core/household-income-us-historical
# Get a list of dataset's resources
curl -L -s https://datahub.io/core/household-income-us-historical/datapackage.json | grep path

# Get resources

curl -L https://datahub.io/core/household-income-us-historical/r/0.csv

curl -L https://datahub.io/core/household-income-us-historical/r/1.zip

If you are using R here's how to get the data you want quickly loaded:

install.packages("jsonlite", repos="https://cran.rstudio.com/")
library("jsonlite")

json_file <- 'https://datahub.io/core/household-income-us-historical/datapackage.json'
json_data <- fromJSON(paste(readLines(json_file), collapse=""))

# get list of all resources:
print(json_data$resources$name)

# print all tabular data(if exists any)
for(i in 1:length(json_data$resources$datahub$type)){
  if(json_data$resources$datahub$type[i]=='derived/csv'){
    path_to_file = json_data$resources$path[i]
    data <- read.csv(url(path_to_file))
    print(data)
  }
}

Note: You might need to run the script with root permissions if you are running on Linux machine

Install the Frictionless Data data package library and the pandas itself:

pip install datapackage
pip install pandas

Now you can use the datapackage in the Pandas:

import datapackage
import pandas as pd

data_url = 'https://datahub.io/core/household-income-us-historical/datapackage.json'

# to load Data Package into storage
package = datapackage.Package(data_url)

# to load only tabular data
resources = package.resources
for resource in resources:
    if resource.tabular:
        data = pd.read_csv(resource.descriptor['path'])
        print (data)

For Python, first install the `datapackage` library (all the datasets on DataHub are Data Packages):

pip install datapackage

To get Data Package into your Python environment, run following code:

from datapackage import Package

package = Package('https://datahub.io/core/household-income-us-historical/datapackage.json')

# print list of all resources:
print(package.resource_names)

# print processed tabular data (if exists any)
for resource in package.resources:
    if resource.descriptor['datahub']['type'] == 'derived/csv':
        print(resource.read())

If you are using JavaScript, please, follow instructions below:

Install data.js module using npm:

  $ npm install data.js

Once the package is installed, use the following code snippet:

const {Dataset} = require('data.js')

const path = 'https://datahub.io/core/household-income-us-historical/datapackage.json'

// We're using self-invoking function here as we want to use async-await syntax:
;(async () => {
  const dataset = await Dataset.load(path)
  // get list of all resources:
  for (const id in dataset.resources) {
    console.log(dataset.resources[id]._descriptor.name)
  }
  // get all tabular data(if exists any)
  for (const id in dataset.resources) {
    if (dataset.resources[id]._descriptor.format === "csv") {
      const file = dataset.resources[id]
      // Get a raw stream
      const stream = await file.stream()
      // entire file as a buffer (be careful with large files!)
      const buffer = await file.buffer
      // print data
      stream.pipe(process.stdout)
    }
  }
})()

Read me

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

Datapackage.json

Request Customized Data


Notifications of data updates and schema changes

Warranty / guaranteed updates

Workflow integration (e.g. Python packages, NPM packages)

Customized data (e.g. you need different or additional data)

Or suggest your own feature from the link below