Data downloads
The numbers behind every page, as JSON and CSV. Generated from the same files the pages read, so a download can't disagree with the site.
Three kinds of number, never mixed up
- Cited Published by someone else. Every row has the value, the period, the source, and a link. If no stable, dated source exists, the row says not yet tracked and the value is blank. It's never filled in with an estimate.
- Assumptions The defaults the calculators start from. Each one says whether it's law, official data, a market convention, or a midpoint we chose.
- Calculated Our math applied to a cited figure. Each row names the figure it started from and how it was computed, and it changes when our defaults (like the mortgage rate) change.
Datasets
| Dataset | Kind | Rows | Download |
|---|---|---|---|
| Cited market figures by neighborhood and boroughEvery rent and sale-price figure shown on a neighborhood or borough page, with the source, period and the area the source actually measured. | Cited | 27 | CSVJSON |
| Income needed for each cited figure (calculated)This site's calculation of the annual income needed to rent at, or buy a co-op or condo at, each area's cited figure. Calculated, not measured: it changes when the site's defaults (mortgage rate, DTI limits) change. | Calculated | 38 | CSVJSON |
| NYC Affordability Index historyEvery published snapshot of the citywide index, one row per metric. A metric with no stable, dated source is listed as not yet tracked with a blank value rather than an estimate. | Cited | 3 | CSVJSON |
| NYC Area Median Income, 2026The 100% AMI row of HPD's 2026 chart by household size. Every other band (30%, 80%, 120%, 165%...) is this row scaled. | Cited | 8 | CSVJSON |
| What New Yorkers earn and pay (Census ACS 2024)Median household income, renter and owner incomes, median gross rent actually paid, and rent burden for NYC and each borough, from the Census Bureau's 2024 American Community Survey 1-year estimates. Survey estimates of residents, not market asking rents. | Mixed | 48 | CSVJSON |
| Calculator default assumptionsEvery default the calculators start from, and what kind of number each one is. "illustrative" means a midpoint this site chose, not a measured figure. | Assumptions | 49 | CSVJSON |
A machine-readable list of everything here, with the field dictionary, is at /data/index.json.
License: public domain (CC0)
To the extent we hold any rights in these files, we've dedicated them to the public domain under CC0 1.0 Universal (public domain dedication) ↗. Use them for anything, commercial included. You don't have to ask or credit us.
One caveat: CC0 covers what this site made, meaning the calculations, the assumptions, and how the data is organized. The Cited figures were published by the source named on each row, such as StreetEasy, Corcoran, Douglas Elliman, Brown Harris Stevens, or NYC HPD. We can't waive their rights for them, so credit them when you reuse a cited figure, and check their terms if you're republishing at scale.
Cited market figures by neighborhood and borough Cited
Every rent and sale-price figure shown on a neighborhood or borough page, with the source, period and the area the source actually measured.
/data/market-figures.csv · /data/market-figures.json · 27 rows
| Field | Meaning |
|---|---|
kind | Always "cited": a figure published by the named source. |
area_type | "neighborhood" or "borough": which page on this site shows the figure. |
area_slug | URL slug of that page. |
area_name | Name of that page's area. |
metric | "median-rent" (median of new leases), "average-rent" (average on leases signed), or "median-sale-price". |
value | The figure, in US dollars (monthly for rents). |
unit_scope | Unit sizes covered: all, studio, 1br, 2br, 3br+. |
property_scope | Property types covered: all, coop, condo, coop+condo. |
geo_kind | What area the source measured: neighborhood, broker-zone, borough, or city. A wider area than the page means the figure is shared. |
geo_name | The source's name for that area. |
period | The period the source reports, as it states it. |
label | Plain-language description shown on the page. |
source | Who published the figure. |
source_url | Where it was published. |
Income needed for each cited figure (calculated) Calculated
This site's calculation of the annual income needed to rent at, or buy a co-op or condo at, each area's cited figure. Calculated, not measured: it changes when the site's defaults (mortgage rate, DTI limits) change.
/data/income-needed.csv · /data/income-needed.json · 38 rows
| Field | Meaning |
|---|---|
kind | Always "calculated": this site's math, not a published figure. |
area_type | "neighborhood" or "borough". |
area_slug | URL slug of the area page. |
area_name | Name of the area. |
scenario | "rent", "coop" or "condo". |
income_needed | Annual gross household income needed, US dollars, rounded to the dollar. |
method | How it was calculated, including the key assumptions. |
based_on_metric | Metric of the cited figure it starts from. |
based_on_value | Value of that cited figure. |
based_on_property_scope | Property types the cited figure covers. |
based_on_period | Period of the cited figure. |
based_on_source | Source of the cited figure. |
based_on_source_url | URL of the cited figure's source. |
NYC Affordability Index history Cited
Every published snapshot of the citywide index, one row per metric. A metric with no stable, dated source is listed as not yet tracked with a blank value rather than an estimate.
/data/affordability-index.csv · /data/affordability-index.json · 3 rows
| Field | Meaning |
|---|---|
kind | Always "cited". |
published_month | Month the snapshot was published on this site (YYYY-MM). Each metric has its own as_of. |
metric | "median-rent", "median-coop-price" or "median-condo-price" (citywide). |
status | "tracked", or "not-yet-tracked" when no stable source was confirmed. |
value | US dollars; blank when not yet tracked. |
as_of | Period the source reports. |
source | Who published the figure. |
source_url | Where it was published. |
NYC Area Median Income, 2026 Cited
The 100% AMI row of HPD's 2026 chart by household size. Every other band (30%, 80%, 120%, 165%...) is this row scaled.
/data/ami-2026.csv · /data/ami-2026.json · 8 rows
| Field | Meaning |
|---|---|
kind | Always "cited". |
year | Chart year. |
household_size | People in the household (1-8). |
ami_100_pct | 100% AMI, US dollars per year. |
source | Publisher. |
source_url | Where it was published. |
What New Yorkers earn and pay (Census ACS 2024) Mixed
Median household income, renter and owner incomes, median gross rent actually paid, and rent burden for NYC and each borough, from the Census Bureau's 2024 American Community Survey 1-year estimates. Survey estimates of residents, not market asking rents.
/data/census-acs-2024.csv · /data/census-acs-2024.json · 48 rows
| Field | Meaning |
|---|---|
kind | "cited" (a Census estimate) or "calculated" (a share this site computed from Census counts). |
year | ACS survey year. |
area_slug | "nyc" or a borough slug. |
area_name | Area name. |
measure | What the row measures. |
value | The estimate (US dollars, a household count, or a share from 0 to 1). |
moe | 90% margin of error as published, where the Census gives one for this row. |
unit | USD/yr, USD/mo, count, or share. |
table | ACS table the figure comes from. |
method | How a calculated share was computed. |
source | Publisher. |
source_url | The table on data.census.gov. |
Calculator default assumptions Assumptions
Every default the calculators start from, and what kind of number each one is. "illustrative" means a midpoint this site chose, not a measured figure.
/data/assumptions.csv · /data/assumptions.json · 49 rows
| Field | Meaning |
|---|---|
kind | Always "assumption". |
key | Identifier in src/data/assumptions.ts. |
label | What the number is. |
value | The default value. |
unit | %, USD, USD/mo, years, months or x. |
basis | law, official-data, market-survey, convention, or illustrative. |
source_org | Who publishes it, when there is a source. |
source_url | Where, when a URL has been checked; blank otherwise. |
effective_date | When the figure applies, if it has a date. |
last_verified | Date someone last checked it against its source; blank if never recorded. |
notes | Caveats. |
How fresh is it?
These files are rebuilt every time the site is deployed. Each cited figure keeps its own period, and the sources page shows when each default was last checked. Two scheduled checks watch for new official data: Freddie Mac's mortgage rate every week, and HPD's AMI chart every month. When either changes, the check opens a pull request on GitHub ↗ that a person reviews before anything changes here. Your own calculator inputs are never in here. They stay in your browser.
Spot a wrong number? Tell us on the contact page or open an issue on GitHub ↗.