Navigate Hoodkit’s city, district, neighborhood, and geospatial area hierarchy.
/api/v1/cities.json
Lists all supported cities.
curl --get 'https://hoodsdk.com/api/v1/cities.json'[
{
"uuid": "city-uuid",
"name": "New York",
"description": "The five boroughs of New York City.",
"slug": "new-york",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"primary_image": {"small": "https://cdn.example.com/small.jpg", "large": "https://cdn.example.com/large.jpg"}
}
]
/api/v1/districts.json?with_neighborhoods=true
Lists districts, optionally embedding their neighborhoods.
| Name | Type | Required | Description |
|---|---|---|---|
with_neighborhoods |
boolean | No | Include neighborhoods for each district. |
city_uuids[] / city_names[] |
array | No | Filter by cities. Unknown cities return 404. |
curl --get 'https://hoodsdk.com/api/v1/districts.json?with_neighborhoods=true'[
{
"id": 2,
"uuid": "district-uuid",
"name": "Brooklyn",
"slug": "brooklyn",
"city": {"uuid": "city-uuid", "name": "New York"},
"neighborhoods": [{"uuid": "neighborhood-uuid", "name": "Greenpoint"}]
}
]
/api/v1/neighborhoods/search.json?q=green&limit=10
Searches neighborhood and district names and returns matches grouped by district.
| Name | Type | Required | Description |
|---|---|---|---|
q |
string | No | Case-insensitive neighborhood or district search. |
district_ids[] |
array | No | Restrict results to district IDs. |
limit |
integer | No | Maximum neighborhoods per district. Defaults to 10. |
curl --get 'https://hoodsdk.com/api/v1/neighborhoods/search.json?q=green&limit=10'{
"districts": [
{
"id": 2,
"name": "Brooklyn",
"slug": "brooklyn",
"neighborhoods": [{"id": 8, "uuid": "neighborhood-uuid", "name": "Greenpoint", "slug": "greenpoint"}],
"total_count": 1,
"has_more": false
}
]
}
/api/v1/areas/search.json?latitude=40.7306&longitude=-73.9352
Finds the geographic area containing a coordinate. Returns an empty object when no area contains the point.
| Name | Type | Required | Description |
|---|---|---|---|
latitude |
number | Yes | Latitude of the point. |
longitude |
number | Yes | Longitude of the point. |
curl --get 'https://hoodsdk.com/api/v1/areas/search.json?latitude=40.7306&longitude=-73.9352'{
"id": 8,
"uuid": "neighborhood-uuid",
"name": "Greenpoint",
"slug": "greenpoint",
"type": "Neighborhood",
"primary_image": {"small": "https://cdn.example.com/small.jpg", "large": "https://cdn.example.com/large.jpg"},
"district": {
"uuid": "district-uuid",
"name": "Brooklyn",
"city": {"uuid": "city-uuid", "name": "New York"}
}
}