ApiNotes
apinotes.io
What it is
ApiNotes turns OpenAPI and Swagger specifications into hosted interactive documentation and a changelog that alerts teams to breaking changes. It accepts OpenAPI 3.0, 3.1, and 3.2, plus Swagger 2.0, in YAML or JSON. Generated references show endpoint parameters, response schemas, code samples in more than 10 programming languages, and a Try-It-Now console. Users can paste, upload, or link a specification and publish documentation at an ApiNotes subdomain. A GitHub Action can publish an updated specification on merge, while the Team plan lists pull request comments about breaking changes. Starter is free and limited to one public API, the last 10 changelog releases, 25 subscribers, and one team member. Team costs $19 a month and includes five APIs, private docs, full changelog history, unlimited subscribers, a custom domain, and five team members. The Team plan has a 14-day trial with no credit card required. Additional APIs are listed at £5/API; Postman, Bruno, and Insomnia integrations are marked as coming soon.
Spec sheet
- What it does
- ApiNotes turns OpenAPI or Swagger specifications into hosted interactive documentation and an automatically generated changelog with breaking-change alerts.Read 30 Sep 2026 · apinotes.io
- AI processing
- If users use the AI fixing tools, relevant specification portions are sent to OpenAI for formatting corrections and are not used to train public models.Read 30 Sep 2026 · apinotes.io
- Data deletion
- After account deletion, personal data and uploaded projects are deleted from production databases within 30 days, while encrypted backups may retain residual data for up to 90 days.Read 30 Sep 2026 · apinotes.io
- Data ownership
- The privacy policy says users retain full intellectual property rights to uploaded specifications, code, and generated documentation.Read 30 Sep 2026 · apinotes.io
- GitHub integration
- A GitHub Action can publish an updated specification on merge, and the Team plan lists PR comments showing breaking changes.Read 30 Sep 2026 · apinotes.io
- Interactive docs
- Generated docs include endpoint parameters, response schemas, code examples in 10+ programming languages, and a built-in Try-It-Now console.Read 30 Sep 2026 · apinotes.io
- Other import integrations
- Postman, Bruno, and Insomnia integrations are marked “Coming soon.”Read 30 Sep 2026 · apinotes.io
- Pricing limits
- Starter is limited to one public API and the last 10 changelog releases; Team includes five APIs, with additional APIs listed at £5/API.Read 30 Sep 2026 · apinotes.io
- Publishing workflow
- Users can paste, upload, or link a specification and publish documentation at an ApiNotes subdomain in under 60 seconds.Read 30 Sep 2026 · apinotes.io
- Service providers
- The privacy policy names AWS or DigitalOcean for hosting, Lemon Squeezy for payments, MongoDB Atlas for the database, and OpenAI for AI processing.Read 30 Sep 2026 · apinotes.io
- Specification access
- Uploaded specifications are stored for documentation hosting and versioning, and the policy says staff do not manually review them unless support troubleshooting is requested.Read 30 Sep 2026 · apinotes.io
- Support and custom plans
- The pricing page invites users who need a custom plan to contact ApiNotes.Read 30 Sep 2026 · apinotes.io
- Supported specifications
- The site lists full support for OpenAPI 3.0, 3.1, 3.2, and Swagger 2.0 specifications in YAML or JSON.Read 30 Sep 2026 · apinotes.io
- Team plan trial
- The Team plan includes a 14-day free trial and says no credit card is needed.Read 30 Sep 2026 · apinotes.io
Plans and prices
Starter Free 1 API (public only) · 10-release changelog · up to 25 subscribers · 1 team member · unlimited validator/diff tools Read 30 Sep 2026 · apinotes.io
Team $19 a month 5 APIs · full changelog history · unlimited subscribers · private docs · 25 guest readers · custom domain · 5 team members Read 30 Sep 2026 · apinotes.io
Strong points and limits
Strong points
- Supports OpenAPI 3.0, 3.1, 3.2, and Swagger 2.0
- Generated docs include a Try-It-Now console
- GitHub Action can publish on merge
- Users retain intellectual property rights to uploads
Limits
- Starter supports only one public API
- Starter changelog shows the last 10 releases
- Postman, Bruno, and Insomnia integrations are coming soon
- Additional APIs are listed at £5/API
Who it suits
ApiNotes suits teams that publish API references from OpenAPI or Swagger files and want changelog alerts for breaking changes. The free Starter plan is limited to one public API, while private documentation and a custom domain are listed with Team.
Verdict
ApiNotes connects specification files to hosted references and breaking-change changelogs, with GitHub publishing support. Check the plan limits and API add-on cost against the number and visibility of docs you need.
Where Specifiction places it
- API Documentation Tools#4 of 278.3
