API Reference

Get Market Snapshot

Pre-computed market statistics for a specific area: active inventory, median rent, average days on market, and concession rate. Optionally filter by bedroom count and listing type.

Snapshots are recomputed daily at 5am UTC.

Container areas (boroughs and other areas with children) roll up their subtree as listed in /areas, so Marble Hill (226) counts toward Manhattan (100) here although search returns it for the Bronx (200). Without a bedrooms filter there is one bucket per exact bedroom count, which can exceed 6. An unknown area ID returns an empty data array rather than an error.

Tier: Free+

GET

market

rentals

snapshot

Get market snapshot for an area

curl --request GET \
  --url https://borough.qwady.app/v1/market/rentals/snapshot \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://borough.qwady.app/v1/market/rentals/snapshot', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://borough.qwady.app/v1/market/rentals/snapshot",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://borough.qwady.app/v1/market/rentals/snapshot"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://borough.qwady.app/v1/market/rentals/snapshot")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "areaId": 120,
      "bedrooms": 1,
      "listingType": "rental",
      "inventory": 245,
      "medianRent": 3500,
      "avgDaysOnMarket": 28.5,
      "concessionRate": 0.12,
      "computedAt": "2026-02-15T05:00:00Z"
    }
  ],
  "meta": {
    "dataAge": "2026-02-15T05:00:00Z",
    "source": "cached"
  }
}

Authorizations

Authorization

string

header

required

Polar.sh license key. Format: BOROUGH-<uuid>

Query Parameters

areaId

integer

required

Area ID (see /areas for the full list)

bedrooms

integer

Filter by bedroom count (0=studio, 1-6). Buckets above 6 appear only in unfiltered responses and cannot be selected here.

Required range: 0 <= x <= 6

listingType

enum<string>

default:rental

Listing type

Available options:

rental,

sale

Response

Market snapshots for the area

data

object[]

Show child attributes

meta

object

Show child attributes

Get market snapshot for an area

curl --request GET \
  --url https://borough.qwady.app/v1/market/rentals/snapshot \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://borough.qwady.app/v1/market/rentals/snapshot', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://borough.qwady.app/v1/market/rentals/snapshot",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://borough.qwady.app/v1/market/rentals/snapshot"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://borough.qwady.app/v1/market/rentals/snapshot")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "areaId": 120,
      "bedrooms": 1,
      "listingType": "rental",
      "inventory": 245,
      "medianRent": 3500,
      "avgDaysOnMarket": 28.5,
      "concessionRate": 0.12,
      "computedAt": "2026-02-15T05:00:00Z"
    }
  ],
  "meta": {
    "dataAge": "2026-02-15T05:00:00Z",
    "source": "cached"
  }
}

Getting Started

Guides

Reference

API Reference

MCP Server

SDK

Get Market Snapshot

Authorizations

Query Parameters

Response