The datasets behind the Ḥeshbon research site, as plain JSON.
These are static files served over GET. There are no query parameters,
no authentication and no write operations. Responses are CORS-open, so a browser or an agent can
fetch them directly.
| Path | What it holds |
|---|---|
/api/v1/communities.json | 269 community records: cost, tax, safety, institution counts |
/api/v1/metrics.json | Field names, scoring factors and comparison metrics |
/api/v1/stories.json | 48 published stories and essays, with season and topic |
/api/v1/status.json | Published dataset versions and record counts |
The OpenAPI 3.1 description lives at /api/v1/openapi.json.
The site also publishes an RFC 9727 API catalog at
/.well-known/api-catalog for automated discovery.
curl -s https://heshbon.org/api/v1/communities.json \
| jq '.communities[] | select(.state == "NJ") | {name, home, safety}'auto_ins, col, desc, elec_c, gas_mcf, has_hs, has_school, home, home3, home5, home_conf, home_ins, inc_rates, kollelim, kosher, kosher_note, lat, lon, metro, mikvahs, name, ou_url, prop_rate, rent4, safety, safety_conf, sales_tax, school_names, schools, shuls, size_idx, state, tuition_conf, tuition_pc, tuition_range, voucher, yeshivish
Fields ending in _conf carry source confidence: src marks a
cited figure, anything else an estimate. See metrics.json for the
scoring factors and the metric-to-field mapping.
An A2A agent answers questions over these same datasets. Its card is at
/.well-known/agent-card.json and the
endpoint speaks JSON-RPC 2.0 at /a2a. It is read-only, single-turn and unauthenticated.
curl -s https://heshbon.org/a2a \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":
{"message":{"kind":"message","role":"user","messageId":"1",
"parts":[{"kind":"text","text":"Which communities are safest?"}]}}}'Three agent skills documenting all of the above are indexed at
/.well-known/agent-skills/index.json,
each published with a SHA-256 digest.
Community records are the dataset behind the affordability map, the comparison tool and the scorecard. Sources for each season are listed on the homepage, and the method behind each figure is stated in the story that uses it.