Microproduct data guideintermediate

CDC ATSDR Social Vulnerability Index

Census-tract and county social-vulnerability rankings for building emergency planning, outreach, and hazard-equity tools.

Start the guide Open official source

At a glance

Difficulty
Intermediate — some data preparation helps
Size
Small · 0.01–0.5 GB
Formats
CSV, JSON
Access
Download or API
API key
Not required
Provider
Agency for Toxic Substances and Disease Registry
Updates
Occasional
Data terms
U.S. Government public data / federal copyright guidance

From source to product signal

Test a product idea in four steps

SVI ranks communities on socioeconomic, household, minority-status, and housing themes derived from ACS. Start with 2022 county ranks for the United States file. Percentiles are relative within one vintage, so do not compare 2020 and 2022 ranks as a time series.

1

Check the setup

  • Python 3.10 or newer
  • A notebook environment such as Jupyter or Google Colab
  • An internet connection
2

Access the data

  1. 1.Open the SVI data-download page and read the comparison-over-time warning.
  2. 2.Query a bounded page of 2022 county ranks from the public feature service.
  3. 3.Keep FIPS codes, county names, and the overall RPL_THEMES percentile.
Open official source
3

Run the Python example

Install the packages, then run the notebook cell.

python -m pip install pandas requests

import pandas as pd
import requests

response = requests.get(
    "https://onemap.cdc.gov/onemapservices/rest/services/SVI/"
    "CDC_ATSDR_Social_Vulnerability_Index_2022_USA/FeatureServer/1/query",
    params={
        "where": "1=1",
        "outFields": "ST,STATE,STCNTY,COUNTY,RPL_THEMES,E_TOTPOP",
        "returnGeometry": "false",
        "resultRecordCount": 50,
        "f": "json",
    },
    timeout=30,
)
response.raise_for_status()
counties = pd.DataFrame(
    [feature["attributes"] for feature in response.json()["features"]]
)
print(counties.head())
4

Test a useful signal

Rank counties by 2022 overall SVI

Test whether SVI percentiles can flag counties for emergency-planning outreach.

  1. 01Keep state, county, FIPS, population, and RPL_THEMES.
  2. 02Sort by overall percentile and report how many ranks are missing.
  3. 03Explain that percentiles are relative within 2022 and should not be subtracted from an earlier SVI vintage.

Dataset details

Agency for Toxic Substances and Disease Registry is a government source. Last verified 2026-08-18. Temporal coverage: 2000-2022 SVI releases.

Theme

Health, Food & Safety

Domains

Community HealthEmergency ManagementDemographics

Data types

TabularGeospatialIndex Scores

Tasks

Risk AssessmentGeographic AnalysisEmergency Planning

Geography

United States

Formats

CSVJSON

Provider

Agency for Toxic Substances and Disease Registry

Data terms

U.S. Government public data / federal copyright guidance