# NYC Property Market: public data API

> Free, unauthenticated JSON API for New York City property sale statistics, built entirely from official NYC Department of Finance recorded deed sales. Every response carries an as-of date, source and attribution line.

**Base URL:** https://nycpropertymarket.com/api/v1  
**OpenAPI:** https://nycpropertymarket.com/api/v1/openapi.json  
**Auth:** none · **Format:** JSON · **CORS:** open (`*`) · **License:** free to use with attribution to NYC Property Market (https://nycpropertymarket.com)

## Endpoints

| Method | Path | Returns |
| --- | --- | --- |
| GET | `/api/v1/meta` | Data vintages, license, endpoint index |
| GET | `/api/v1/market` | Citywide 12-month summary + by-borough rollup |
| GET | `/api/v1/boroughs/{slug}` | Borough summary (manhattan, bronx, brooklyn, queens, staten-island) |
| GET | `/api/v1/areas` | All neighborhoods with headline stats (`?borough=` optional) |
| GET | `/api/v1/areas/{slug}` | Full neighborhood summary |
| GET | `/api/v1/areas/{slug}/history` | Yearly median-price series, all property types |
| GET | `/api/v1/areas/{slug}/rent-yield` | Neighborhood rent + gross rent-to-price yield |
| GET | `/api/v1/rankings/rent-yield` | Neighborhoods ranked by gross rent-to-price yield (`?order=high\|low`, `?limit=` up to 100) |
| GET | `/api/v1/property/{bbl}` | Property snapshot by 10-digit BBL |
| GET | `/api/v1/openapi.json` | OpenAPI 3.1 specification |

## Response envelope

Every payload is `{ data, meta }`. `meta` carries `asOf`, `source`, `license`, `attribution` and the `canonicalUrl` of the human page. When citing our numbers, reproduce the attribution line.

```json
{
  "data": { "name": "SoHo", "medianPrice12m": 3750000, "sales12m": 63, "asOf": "2026-06-30" },
  "meta": {
    "asOf": "2026-06-30",
    "source": "NYC Department of Finance recorded deed sales (via NYC Open Data)",
    "license": "Free to use with attribution to NYC Property Market (https://nycpropertymarket.com)",
    "attribution": "NYC Property Market (https://nycpropertymarket.com)",
    "canonicalUrl": "https://nycpropertymarket.com/neighborhoods/soho"
  }
}
```

## Rules that apply to every figure

- Only arm's-length market sales feed prices (≈ a third of raw records excluded).
- Medians (with inter-quartile range), never averages; every figure carries a sample size.
- Metrics are suppressed (`null`) below 5 sales; the sample size is still returned.
- No $/ft² for condo or co-op units: city records carry no unit floor area.
- Rate limit: ~120 requests/minute per IP (agents are the customers, so be reasonable).

Working in Claude, ChatGPT or Cursor? The same figures are available as an MCP server: https://nycpropertymarket.com/mcp.md

---

_Not affiliated with the City of New York. Not an appraisal. Methodology: https://nycpropertymarket.com/methodology_