/api/v1/websites/buildings.json?limit=100&offset=0
Returns a paginated building feed with optional inventory and geographic filters.
commute is the neighborhood's precomputed subway context, not a measurement from the building itself: every building in a neighborhood carries the same numbers. It is null when the building has no neighborhood. See the overview endpoint for what the numbers mean.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
with_available_listings |
boolean | No | Only buildings joined to available listings. |
uuids[] |
array | No | Fetch specific building UUIDs. Bypasses limit and offset. |
limit |
integer | No | Page size, from 1 to 200. Defaults to 100. |
offset |
integer | No | Record offset. Defaults to 0. |
neighborhood_uuids[] |
array | No | Filter by neighborhoods. |
district_uuids[] |
array | No | Filter by districts. |
city_uuids[] |
array | No | Filter by cities. |
Example request
curl --get 'https://hoodsdk.com/api/v1/websites/buildings.json?limit=100&offset=0' \
--header 'WEBSITES_API_TOKEN: YOUR_TOKEN'Example response 200 OK
{
"limit": 100,
"offset": 0,
"total_count": 1,
"buildings": [
{
"id": 101,
"uuid": "building-uuid",
"latitude": 40.7241,
"longitude": -73.9501,
"full_address": "123 Example Street, Brooklyn, NY 11222",
"address_line_one": "123 Example Street",
"zip_code": "11222",
"scr_building_token": "building-token",
"unified_address_id": "100001",
"neighborhood": {
"name": "Greenpoint",
"uuid": "neighborhood-uuid",
"commute": {
"walk_meters": 308,
"walk_minutes": 5,
"computed_at": "2026-08-16T08:10:00.000Z",
"nearest_stop": {"id": 9, "external_id": "G26", "name": "Greenpoint Av", "lines": ["G"]},
"hubs": [
{"key": "union_square", "name": "Union Square", "walk_minutes": 5, "transit_minutes": 14, "total_minutes": 19}
]
}
},
"district": {"name": "Brooklyn", "uuid": "district-uuid"},
"city": {"name": "New York", "uuid": "city-uuid"}
}
]
}