Income by ZIP Code (IRS Tax Data API)

Get official income statistics for any US ZIP code from the IRS Statistics of Income program: number of tax returns, average adjusted gross income, the income-bracket mix, wages and retiree share. Look up a list of ZIPs, or pull a whole state at once.

Who uses this

• Local businesses and franchise scouts picking a trade area or a new location
• Real-estate investors and agents comparing neighborhoods
• Marketers building direct-mail or ad lists by income band
• Analysts and AI agents that need a clean income field for a ZIP

How to use

Example use cases

1. Site selection: compare average income across candidate ZIPs before opening a store or office.
2. Marketing & ads: pick high-income ZIPs for direct mail or geo-targeted campaigns.
3. Real estate & research: add IRS income brackets to ZIP-level analysis or dashboards.

Steps: 1) Click Try for free — the form is pre-filled with the example below. 2) Press Start. 3) Download results as JSON, CSV or Excel, or connect them to Sheets, Zapier, Make or Slack. Schedule it to run daily/weekly.

Example input (the prefilled form):

{"zipCodes": ["77459", "78701", "10001", "94105", "60614"], "mode": "summary"}

Sample output (first row of a real run on 2026-10-15, long fields trimmed):

{
 "taxYear": 2022,
 "state": "CA",
 "zip": "94105",
 "returns": 8050,
 "totalAgi": 3056957000,
 "avgAgi": 379746.21,
 "medianAgiBracket": "$100k–$200k",
 "wageEarners": 7240,
 "totalWages": 2011656000,
 "elderlyReturns": 840,
 "shareOver100k": 0.6944,
 "shareUnder25k": 0.0882,
 "source": "https://www.irs.gov/pub/irs-soi/22zpallagi.csv",
 "disclaimer": "IRS SOI ZIP Code data. AGI figures from published tables. Not a credit decision tool."
}

Pricing: pay per event — $0.01 per zip income row. No monthly rental; you only pay for results. Set a max charge per run to cap spend.

Why this Actor

• Official source: the IRS's own ZIP code file (tax years 2020 to 2022), not modelled estimates.
• One clean row per ZIP: totals plus the share under $25k and over $100k, and the median income bracket.
• Bracket mode: set mode to brackets for one row per income band per ZIP.
• Pay only for results. No subscription, no proxy, no login.

Input example

{ "taxYear": "2022", "zipCodes": ["77459", "77002", "78701", "10001", "90210"], "mode": "summary" }

Leave zipCodes empty and set states (for example ["TX"]) to pull every ZIP in a state.

Output example

{ "taxYear": 2022, "state": "CA", "zip": "90210", "returns": 9030, "avgAgi": 664871.87, "medianAgiBracket": "$100k–$200k", "wageEarners": 5780, "elderlyReturns": 3600, "shareOver100k": 0.5615, "shareUnder25k": 0.1894 }

FAQ

Is this household income? It's income per tax return, which is close but not the same as household income. It's the most precise official figure published at ZIP level. How current is it? Tax year 2022 is the latest ZIP release from the IRS. The Actor picks up new years when the IRS publishes them. Can I use it from ChatGPT or Claude? Yes, it's also one of the tools in the Public Data MCP server.

Data & legal

Public IRS data. No personal data. Not a credit decision tool, and not legal, financial or tax advice.