Household Pulse Survey

The following is available API dataset for Household Pulse Survey.

All queries to the Census Data API now require an API key. Please cut and paste the API Calls, Example Calls, Variables, Examples, and Supported Geography below into your web browser and replace YOUR_KEY_GOES_HERE with your personal API Key.

If you do not have an API Key, request one here.

Time Series: Household Pulse Survey: High Frequency Social and Economic Data

  • API Call: api.census.gov/data/timeseries/hhpulse?key=YOUR_KEY_GOES_HERE
  • Geography: api.census.gov/data/timeseries/hhpulse/geography.html?key=YOUR_KEY_GOES_HERE
  • Variables: api.census.gov/data/timeseries/hhpulse/variables.html?key=YOUR_KEY_GOES_HERE
  • Example Call:

api.census.gov/data/timeseries/hhpulse?get=SURVEY_YEAR,NAME&for=state:*&time=2024&CYCLE=01&key=YOUR_KEY_GOES_HERE

Time Series: Household Pulse Survey: Coronavirus (COVID-19) Pandemic and Recovery

  • API Call: api.census.gov/data/timeseries/hps?key=YOUR_KEY_GOES_HERE
  • Geography: api.census.gov/data/timeseries/hps/geography.html?key=YOUR_KEY_GOES_HERE
  • Variables: api.census.gov/data/timeseries/hps/variables.html?key=YOUR_KEY_GOES_HERE
  • Example Call:

api.census.gov/data/timeseries/hps?get=NAME,SURVEY_YEAR&for=state:*&time=2020&key=YOUR_KEY_GOES_HERE

Related Information

Page Last Revised - May 14, 2026