{
  "title": "nyc-affordability.com public data",
  "homepage": "https://nyc-affordability.com/data/",
  "generated": "2026-10-04",
  "license": {
    "id": "CC0-1.0",
    "name": "CC0 1.0 Universal (public domain dedication)",
    "url": "https://creativecommons.org/publicdomain/zero/1.0/",
    "note": "CC0 covers this site's compilation, calculations and assumptions. Cited market figures were published by the source named on each row; please credit them when you reuse those figures."
  },
  "datasets": [
    {
      "id": "market-figures",
      "title": "Cited market figures by neighborhood and borough",
      "description": "Every rent and sale-price figure shown on a neighborhood or borough page, with the source, period and the area the source actually measured.",
      "kind": "cited",
      "rows": 27,
      "files": {
        "json": "/data/market-figures.json",
        "csv": "/data/market-figures.csv"
      },
      "columns": [
        {
          "key": "kind",
          "description": "Always \"cited\": a figure published by the named source."
        },
        {
          "key": "area_type",
          "description": "\"neighborhood\" or \"borough\": which page on this site shows the figure."
        },
        {
          "key": "area_slug",
          "description": "URL slug of that page."
        },
        {
          "key": "area_name",
          "description": "Name of that page's area."
        },
        {
          "key": "metric",
          "description": "\"median-rent\" (median of new leases), \"average-rent\" (average on leases signed), or \"median-sale-price\"."
        },
        {
          "key": "value",
          "description": "The figure, in US dollars (monthly for rents)."
        },
        {
          "key": "unit_scope",
          "description": "Unit sizes covered: all, studio, 1br, 2br, 3br+."
        },
        {
          "key": "property_scope",
          "description": "Property types covered: all, coop, condo, coop+condo."
        },
        {
          "key": "geo_kind",
          "description": "What area the source measured: neighborhood, broker-zone, borough, or city. A wider area than the page means the figure is shared."
        },
        {
          "key": "geo_name",
          "description": "The source's name for that area."
        },
        {
          "key": "period",
          "description": "The period the source reports, as it states it."
        },
        {
          "key": "label",
          "description": "Plain-language description shown on the page."
        },
        {
          "key": "source",
          "description": "Who published the figure."
        },
        {
          "key": "source_url",
          "description": "Where it was published."
        }
      ]
    },
    {
      "id": "income-needed",
      "title": "Income needed for each cited figure (calculated)",
      "description": "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.",
      "kind": "calculated",
      "rows": 38,
      "files": {
        "json": "/data/income-needed.json",
        "csv": "/data/income-needed.csv"
      },
      "columns": [
        {
          "key": "kind",
          "description": "Always \"calculated\": this site's math, not a published figure."
        },
        {
          "key": "area_type",
          "description": "\"neighborhood\" or \"borough\"."
        },
        {
          "key": "area_slug",
          "description": "URL slug of the area page."
        },
        {
          "key": "area_name",
          "description": "Name of the area."
        },
        {
          "key": "scenario",
          "description": "\"rent\", \"coop\" or \"condo\"."
        },
        {
          "key": "income_needed",
          "description": "Annual gross household income needed, US dollars, rounded to the dollar."
        },
        {
          "key": "method",
          "description": "How it was calculated, including the key assumptions."
        },
        {
          "key": "based_on_metric",
          "description": "Metric of the cited figure it starts from."
        },
        {
          "key": "based_on_value",
          "description": "Value of that cited figure."
        },
        {
          "key": "based_on_property_scope",
          "description": "Property types the cited figure covers."
        },
        {
          "key": "based_on_period",
          "description": "Period of the cited figure."
        },
        {
          "key": "based_on_source",
          "description": "Source of the cited figure."
        },
        {
          "key": "based_on_source_url",
          "description": "URL of the cited figure's source."
        }
      ]
    },
    {
      "id": "affordability-index",
      "title": "NYC Affordability Index history",
      "description": "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.",
      "kind": "cited",
      "rows": 3,
      "files": {
        "json": "/data/affordability-index.json",
        "csv": "/data/affordability-index.csv"
      },
      "columns": [
        {
          "key": "kind",
          "description": "Always \"cited\"."
        },
        {
          "key": "published_month",
          "description": "Month the snapshot was published on this site (YYYY-MM). Each metric has its own as_of."
        },
        {
          "key": "metric",
          "description": "\"median-rent\", \"median-coop-price\" or \"median-condo-price\" (citywide)."
        },
        {
          "key": "status",
          "description": "\"tracked\", or \"not-yet-tracked\" when no stable source was confirmed."
        },
        {
          "key": "value",
          "description": "US dollars; blank when not yet tracked."
        },
        {
          "key": "as_of",
          "description": "Period the source reports."
        },
        {
          "key": "source",
          "description": "Who published the figure."
        },
        {
          "key": "source_url",
          "description": "Where it was published."
        }
      ]
    },
    {
      "id": "ami-2026",
      "title": "NYC Area Median Income, 2026",
      "description": "The 100% AMI row of HPD's 2026 chart by household size. Every other band (30%, 80%, 120%, 165%...) is this row scaled.",
      "kind": "cited",
      "rows": 8,
      "files": {
        "json": "/data/ami-2026.json",
        "csv": "/data/ami-2026.csv"
      },
      "columns": [
        {
          "key": "kind",
          "description": "Always \"cited\"."
        },
        {
          "key": "year",
          "description": "Chart year."
        },
        {
          "key": "household_size",
          "description": "People in the household (1-8)."
        },
        {
          "key": "ami_100_pct",
          "description": "100% AMI, US dollars per year."
        },
        {
          "key": "source",
          "description": "Publisher."
        },
        {
          "key": "source_url",
          "description": "Where it was published."
        }
      ]
    },
    {
      "id": "census-acs-2024",
      "title": "What New Yorkers earn and pay (Census ACS 2024)",
      "description": "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.",
      "kind": "mixed",
      "rows": 48,
      "files": {
        "json": "/data/census-acs-2024.json",
        "csv": "/data/census-acs-2024.csv"
      },
      "columns": [
        {
          "key": "kind",
          "description": "\"cited\" (a Census estimate) or \"calculated\" (a share this site computed from Census counts)."
        },
        {
          "key": "year",
          "description": "ACS survey year."
        },
        {
          "key": "area_slug",
          "description": "\"nyc\" or a borough slug."
        },
        {
          "key": "area_name",
          "description": "Area name."
        },
        {
          "key": "measure",
          "description": "What the row measures."
        },
        {
          "key": "value",
          "description": "The estimate (US dollars, a household count, or a share from 0 to 1)."
        },
        {
          "key": "moe",
          "description": "90% margin of error as published, where the Census gives one for this row."
        },
        {
          "key": "unit",
          "description": "USD/yr, USD/mo, count, or share."
        },
        {
          "key": "table",
          "description": "ACS table the figure comes from."
        },
        {
          "key": "method",
          "description": "How a calculated share was computed."
        },
        {
          "key": "source",
          "description": "Publisher."
        },
        {
          "key": "source_url",
          "description": "The table on data.census.gov."
        }
      ]
    },
    {
      "id": "assumptions",
      "title": "Calculator default assumptions",
      "description": "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.",
      "kind": "assumption",
      "rows": 49,
      "files": {
        "json": "/data/assumptions.json",
        "csv": "/data/assumptions.csv"
      },
      "columns": [
        {
          "key": "kind",
          "description": "Always \"assumption\"."
        },
        {
          "key": "key",
          "description": "Identifier in src/data/assumptions.ts."
        },
        {
          "key": "label",
          "description": "What the number is."
        },
        {
          "key": "value",
          "description": "The default value."
        },
        {
          "key": "unit",
          "description": "%, USD, USD/mo, years, months or x."
        },
        {
          "key": "basis",
          "description": "law, official-data, market-survey, convention, or illustrative."
        },
        {
          "key": "source_org",
          "description": "Who publishes it, when there is a source."
        },
        {
          "key": "source_url",
          "description": "Where, when a URL has been checked; blank otherwise."
        },
        {
          "key": "effective_date",
          "description": "When the figure applies, if it has a date."
        },
        {
          "key": "last_verified",
          "description": "Date someone last checked it against its source; blank if never recorded."
        },
        {
          "key": "notes",
          "description": "Caveats."
        }
      ]
    }
  ]
}