Hoodkit Developer Platform

Build with neighborhood data

Use Hoodkit’s read-only JSON API to find places, understand geographic areas, locate transport, and retrieve property data.

Make your first request Browse Places API

Quickstart

All endpoints are under the versioned /api/v1 path and return JSON. Public endpoints require no authentication.

curl --get 'https://hoodsdk.com/api/v1/places/search.json?search_phrase=coffee&limit=5'

Conventions

JSON responses

Append .json or send Accept: application/json. Examples below use the suffix for clarity.

Cross-origin access

Requests to /api/* support CORS from any origin.

City filters

Supported endpoints accept city_uuids[] and city_names[]. Singular aliases are normalized too.

Errors

Validation and lookup failures use HTTP status codes. JSON errors generally have the shape {"error":"Message"}.

Authentication

Places, geography, transport, and property endpoints are public. The partner Websites API requires a token in the WEBSITES_API_TOKEN request header. Contact the Hoodkit team to request access.

Keep partner tokens on your server. Never expose them in browser JavaScript or public repositories.

GET /api/v1/launcher/search.json?q=coffee

Searches navigation, geography, addresses, lots, transit and owners of record for command-palette style experiences. Every collection is present on every response; new ones are added and existing ones are never renamed. Searches data when q has at least two characters.

Query parameters

Name	Type	Required	Description
`q`	string	No	Search text. Data results begin at two characters.

Example request

curl --get 'https://hoodsdk.com/api/v1/launcher/search.json?q=coffee'

Example response 200 OK

{
  "navigation": [{"id": "nav-places", "name": "All Places", "type": "navigation", "path": "/places/all", "subtitle": null, "icon": "map-pin", "label": "All Places", "keywords": "places restaurants bars cafes shops"}],
  "places": [{"id": 42, "name": "Example Cafe", "type": "place", "path": "/places/abc123", "subtitle": "Cafe", "icon": "coffee", "token": "abc123", "place_type": "cafe"}],
  "neighborhoods": [],
  "districts": [],
  "cities": [],
  "addresses": [],
  "lots": [],
  "transport_stops": [],
  "transport_lines": [],
  "owners": []
}

GET /api/v1/overview/show.json?latitude=40.7306&longitude=-73.9352

Returns the containing area, nearby places, and nearby transport stops in one request.

When the point falls in a neighborhood, commute carries precomputed subway context: the walk to the nearest station and rough minutes to each job centre, soonest first. The numbers are estimates refreshed weekly from the GTFS schedule — a wait of half a headway, the scheduled ride, and another wait plus the walk at every change of line. Nothing is routed at request time. A hub the nearest station cannot reach is left out, and nearest_stop is null where no station is within 1.5 miles. Districts have no commute block.

Query parameters

Name	Type	Required	Description
`latitude`	number	Yes	Latitude of the point.
`longitude`	number	Yes	Longitude of the point.
`radius`	integer	No	Search radius in miles. Defaults to 1.
`limit`	integer	No	Maximum nearby records. Defaults to 30.

Example request

curl --get 'https://hoodsdk.com/api/v1/overview/show.json?latitude=40.7306&longitude=-73.9352'

Example response 200 OK

{
  "area": {
    "id": 12,
    "name": "Greenpoint",
    "area_type": "Neighborhood",
    "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},
        {"key": "grand_central", "name": "Grand Central", "walk_minutes": 5, "transit_minutes": 25, "total_minutes": 30}
      ]
    }
  },
  "places": [{"id": 42, "name": "Example Cafe", "distance": 0.2}],
  "stops": [{"id": 9, "name": "Greenpoint Av", "transport_type": "subway"}]
}