> ## Documentation Index
> Fetch the complete documentation index at: https://qwady.wiki/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Structured NYC real estate data via REST API

Borough is a REST API that provides structured access to NYC real estate data including rental and sale listings, building details, neighborhood boundaries, market statistics, building quality scores, and FCC-backed internet provider availability.

## What Borough provides

* **Dozens of structured listing fields** across summary and detail endpoints, including pricing, concessions, amenities, photos, and freshness metadata
* **Building-level data** with amenities, policies, NYC regulatory data, and quality scores
* **First-party photo delivery** through `/v1/photos/{key}` for supported Borough image sizes
* **Likely internet providers** with FCC-sourced provider names, technologies, and advertised speeds
* **316 NYC neighborhoods and sub-areas** with encoded map boundaries (349 areas in total, including the five boroughs and Northern New Jersey)
* **Market snapshots** with inventory, median prices, days on market, and concession rates
* **Building quality scores** derived from NYC Open Data (HPD violations, 311 noise, NYPD crime, transit proximity)
* **Live SSE streaming** that delivers cached data immediately, then live data (Pro+)
* **Persistent watchers** that monitor listings, buildings, or searches for changes (Business+)
* **Webhooks** for automated notifications on price drops, new listings, and status changes (Business+)
* **MCP server** for connecting AI agents directly to NYC real estate data

## Pricing

| Tier     | Price   | Requests/month | Rate Limit |
| -------- | ------- | -------------- | ---------- |
| Free     | \$0     | 100            | 10/min     |
| Starter  | \$19/mo | 5,000          | 30/min     |
| Pro      | \$49/mo | 25,000         | 60/min     |
| Business | \$99/mo | 100,000        | 120/min    |

Free tier covers search, area reference, market snapshots, and photo delivery. The public `/v1/health` endpoint is also available without authentication, but it is outside Borough's metered `/v1` data surface. Starter and above add property details and building data. Pro adds live SSE streaming. Business adds webhooks, persistent watchers, and change notifications.

## Product surface

Borough keeps its public product pages and service runtime on the same hostname without changing the integration URLs developers depend on.

* Public site and legal pages live at `borough.qwady.app/`
* REST endpoints stay under `borough.qwady.app/v1/*`
* MCP remains at `borough.qwady.app/mcp`
* OAuth and discovery stay under `borough.qwady.app/oauth/*` and `borough.qwady.app/.well-known/*`
* Webhook subscriptions stay under `borough.qwady.app/v1/webhooks/*`

## Internet provider availability

Building and property detail responses can include an `internetProviders` block sourced from official FCC Broadband Data Collection public data.

* Coverage is **exact-building** when Borough has a matched FCC location and **Census-block level** when sourced from FCC public bulk files
* Coverage is not unit-specific qualification
* Data reflects likely providers, advertised technologies, and max download/upload speeds
* The FCC publishes this dataset **twice a year**. Borough checks monthly and re-imports when a new FCC filing period is available, so in most months there is nothing new to pull. Manual backfills are supported for operational re-syncs
* Broadband data currently covers about **76.5%** of eligible buildings, meaning those with an active listing and a geocoded location. Buildings with no active listing are out of scope by design

> This product uses FCC APIs and/or Data but is not endorsed or certified by the FCC.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/borough/quickstart">
    Get your API key and make your first request in under 2 minutes
  </Card>

  <Card title="API Reference" icon="code" href="/borough/api-reference/overview">
    Explore all 20+ endpoints with examples and response schemas
  </Card>

  <Card title="MCP Server" icon="microchip" href="/borough/mcp/overview">
    Connect Claude, Cursor, or VS Code to query NYC data via AI
  </Card>

  <Card title="TypeScript SDK" icon="npm" href="/borough/sdk">
    Install the official SDK for typed access with auto-pagination
  </Card>
</CardGroup>
