Bump.sh and ApiNotes both publish docs from an OpenAPI file and track what changed. ApiNotes includes the changelog on its free plan and costs a flat $19 on Team; Bump.sh adds AsyncAPI, Arazzo and MCP support.
Bump.sh is the closest product to ApiNotes: hosted API docs from a spec, a CLI and GitHub integration, version tracking and a changelog. It goes further on spec formats and AI: it supports AsyncAPI and Arazzo, and promotes turning APIs into MCP servers. Plans on its pricing page start at $50 per month (Basic) and $120 per month (Pro), and the automatic changelog is listed on Pro.
ApiNotes is the lighter, cheaper option for OpenAPI and Swagger teams. The automatic changelog, breaking-change detection and subscriber emails are on the free Starter plan, and Team is $19/month flat with custom domain, private docs and five team members.
| Feature | Bump.sh | ApiNotes |
|---|---|---|
| Basics | ||
| What it is | Hosted API docs + changelog platform | Hosted docs + changelog platform |
| Hosting included | ✅ Included | ✅ your-api.apinotes.io, CDN-cached |
| Custom domain | ✅ Custom domain and logo (Basic and up) | ✅ CNAME, TLS handled (Team) |
| Documentation | ||
| Layout | ✅ Reference and hubs | ✅ Three-column reference |
| Code samples | ✅ Multiple languages | ✅ 10+ languages per endpoint |
| Try-it console | ✅ API Explorer (Pro) | ✅ Try-it panel with auth |
| Search | ✅ Built-in search | ✅ Full-text across endpoints and guides |
| Guides and prose pages | ✅ Guides and hubs | ✅ Documentation editor |
| Server-side rendering / SEO | ✅ Server-rendered | ✅ SSR, indexable, per-project meta |
| Change management | ||
| Version history | ✅ Branches and rollback (Pro) | ✅ Every push kept, switch versions in docs |
| Automatic changelog | ✅ Automatic changelog (Pro) | ✅ Written from the spec diff on every push |
| Breaking-change detection | ✅ Diff and breaking changes | ✅ Flagged per release |
| Email subscribers + RSS/JSON feed | ⚠️ Check current plan | ✅ 25 on Starter, unlimited on Team |
| CI/CD and access | ||
| Publish from CI | ✅ CLI and GitHub integration | ✅ GitHub Action or one API call |
| PR comment with breaking changes | ✅ Diff comments in CI | ✅ GitHub Action (Team) |
| Spec validation | ✅ Spec validation | ✅ Validator with line numbers and hints |
| Private docs | ✅ Role-based access (Pro) | ✅ Password or magic link (Team) |
| Price | $50 (Basic) / $120 (Pro) per month; no free plan listed | Free Starter / $19 per month Team, flat |
Bump.sh plan details from bump.sh/pricing as of October 2026. Bump.sh also supports AsyncAPI, Arazzo and MCP servers, which ApiNotes does not. Verified October 2026.
Bump.sh lists Basic at $50 per month and Pro at $120 per month, with no free plan on the pricing page. Several features people compare on, such as the automatic changelog and API Explorer, are Pro features.
ApiNotes Starter is free and includes the automatic changelog (last 10 releases), breaking-change detection, subscriber emails, the Try-it panel and the GitHub Action. Team adds full history and more for $19.
Bump.sh supports OpenAPI, AsyncAPI and Arazzo, and offers MCP server tooling built from your API. If event-driven APIs or agent workflows are central, that is a real advantage.
ApiNotes focuses on OpenAPI 2.0 through 3.2. If you do not need AsyncAPI, Arazzo or MCP, you are not paying for them.
Plans limit internal and external users (for example 3 internal and 20 external on Basic).
Team includes five team members and 25 invite-only guest readers, and the public docs themselves are open to anyone.
Both tools publish from CI, keep version history and tell consumers what changed. The core workflow is the same.
The difference is mostly price, plan gating and Bump.sh's extra formats. Try both with the same spec.
Bump.sh lists Basic at $50 per month (10 API docs, 3 internal users, 20 external users), Pro at $120 per month (30 API docs, automatic changelog, API Explorer, branches, RBAC) and custom pricing above that.
Starter, $0: 1 public API, hosted docs, changelog for the last 10 releases, breaking-change detection, 25 subscribers, GitHub Action, Try-it panel. Team, $19/month flat: 5 APIs, full changelog history, unlimited subscribers, PR comments, private docs, 25 guest readers, custom domain, your own branding, 5 team members. 14-day trial, no card needed.
Paste the same OpenAPI file you use today. Hosted docs, a changelog and breaking-change alerts are live in under a minute.