{"apiVersion":"v1","name":"Havoptic Public API","description":"Read-only JSON API for the Havoptic AI coding tool release dataset. No authentication. Please cache responses; be kind (~60 req/min).","documentation":"https://www.havoptic.com/api-docs","openapi":"https://www.havoptic.com/openapi.json","mcpServer":{"transport":"streamable-http","url":"https://mcp.havoptic.com/mcp"},"endpoints":[{"path":"/api/v1/releases","params":"tool, vendor, category, type (release|prerelease), bump (major|minor|patch|unknown), channel, breaking, security, since, until, updated_since, q, sort (-published_at|published_at|product), expand (changes|notes|product), fields, limit (<=100), cursor, offset","description":"Filterable, paginated release list (summaries)"},{"path":"/api/v1/releases/{id}","description":"One release with full notes"},{"path":"/api/v1/tools","params":"vendor, category, status (default active), q","description":"Tracked tools with counts, latest release and source health"},{"path":"/api/v1/tools/{id}","description":"One tool: metadata, latest stable/prerelease, cadence summary, source health"},{"path":"/api/v1/tools/{id}/releases","params":"same as /api/v1/releases","description":"Shortcut for /api/v1/releases?tool={id}"},{"path":"/api/v1/tools/{id}/versions/{version}","params":"version: latest, 1.2.3, v1.2.3, rust-v1.2.3; expand","description":"Resolve one version of a tool"},{"path":"/api/v1/tools/{id}/cadence","params":"window (7d|30d|90d, optional)","description":"Release cadence stats for one tool"},{"path":"/api/v1/compare","params":"tools=a,b[,c,d], aspects (cadence,features,recent_changes,verdict), since","description":"Compare 2–4 tools: cadence, feature diff, recent changes, editorial verdicts"},{"path":"/api/v1/features","params":"q, tool, source (timeline|matrix)","description":"Feature catalog with stable ids: first-to-ship adoption + per-tool support"},{"path":"/api/v1/features/{id}","description":"One feature"},{"path":"/api/v1/trends/cadence","params":"window (default 30d), tools","description":"Release velocity across tools with a 12-week series"},{"path":"/api/v1/trends/feature-adoption","description":"Who copies whom: follower lag and leaders per feature"},{"path":"/api/v1/trends/mechanics","params":"behavior, mechanic (optional)","description":"Behaviors + mechanics taxonomy (v1 envelope)"},{"path":"/api/v1/feature-timeline","params":"feature (optional)","description":"First-to-ship feature timeline + copying-trend insights"},{"path":"/api/v1/mechanics","params":"behavior, mechanic (optional)","description":"Behaviors + mechanics taxonomy joined with first-ship dates"},{"path":"/api/v1/changes","params":"tool, kind, since, until, limit, cursor","description":"Typed change items (enriched releases only)"},{"path":"/api/v1/digest","params":"since (required), tools, max_items, Accept: text/markdown","description":"Rollup digest for agents"},{"path":"/api/v1/search","params":"q (required), tool, limit, scope","description":"Search changes + legacy notes"},{"path":"/api/v1/vendors","description":"Vendor catalog from registry"},{"path":"/api/v1/tools/{id}/latest","params":"channel=stable|prerelease","description":"Latest release for one tool"},{"path":"/api/v1/tools/{id}/upgrade","params":"from, to, Accept: text/markdown","description":"Upgrade intelligence between versions"},{"path":"/api/v1/changelog","params":"Accept: text/markdown","description":"Changelog of this API"},{"path":"/api/v1/status","description":"Dataset and per-source freshness (last success, last error, last release)"},{"path":"/api/v1/schemas/{name}.json","description":"JSON Schema 2020-12 for each response object"},{"path":"/api/v1/export/manifest.json","description":"Bulk export manifest: files, row counts, sha256, columns, license (CC BY 4.0), daily deltas"},{"path":"/api/v1/export/releases.{json,ndjson,csv,parquet}","description":"Full release snapshot download (streamed, Content-Disposition: attachment)"},{"path":"/api/v1/export/changes.ndjson","description":"Every typed change item, one per line"},{"path":"/api/v1/export/deltas/{YYYY-MM-DD}.ndjson","description":"Releases whose record changed that UTC day ({op, id, changed_at, record} lines)"}],"bulkData":["https://www.havoptic.com/api/v1/export/manifest.json","https://www.havoptic.com/data/releases.json","https://www.havoptic.com/data/feature-matrix.json","https://www.havoptic.com/data/mechanics.json"],"license":{"id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"Havoptic (https://www.havoptic.com)"}}