- Home
- API Documentation Tools
- ApiNotes
ApiNotes
What it is
ApiNotes converts OpenAPI and Swagger specifications into hosted interactive documentation and generates a changelog with alerts for breaking changes. It supports OpenAPI 3.0, 3.1, and 3.2, as well as Swagger 2.0, in YAML or JSON. Generated references include endpoint parameters, response schemas, code examples in 10+ programming languages, and a Try-It-Now console. Users can paste, upload, or link a specification and publish to an ApiNotes subdomain in under 60 seconds. A GitHub Action can publish a revised specification on merge; the Team plan also lists pull request comments about breaking changes. Starter is free and supports one public API, the last 10 changelog releases, up to 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. It includes a 14-day trial without a credit card. Additional APIs are listed at £5/API. Postman, Bruno, and Insomnia integrations are marked as coming soon.
For and against
For
- Supports OpenAPI 3.0, 3.1, 3.2, and Swagger 2.0
- Generated references include examples in 10+ languages
- GitHub Action can publish updates on merge
- Team includes a 14-day trial without a credit card
Against
- Starter supports one public API
- Starter retains only the last 10 changelog releases
- Postman, Bruno, and Insomnia integrations are coming soon
The verdict
ApiNotes offers a direct path from specification files to hosted interactive references and breaking-change tracking. The free plan is limited to one public API, while private documentation and fuller changelog history are part of the paid Team plan.
Who it suits
ApiNotes suits developers and teams that publish API references from OpenAPI or Swagger files and want changelog alerts. The free plan is geared to a single public API; teams needing private docs or multiple APIs may consider Team.
Plans and prices
Starter
1 API (public only) · 10-release changelog · up to 25 subscribers · 1 team member
Read 30 Sep 2026 · apinotes.io
Team
5 APIs · full changelog history · unlimited subscribers · private docs
Read 30 Sep 2026 · apinotes.io
On the record
- 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.apinotes.io · read 30 Sep 2026
- 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.apinotes.io · read 30 Sep 2026
- Data ownership
- The privacy policy says users retain full intellectual property rights to uploaded specifications, code, and generated documentation.apinotes.io · read 30 Sep 2026
- GitHub integration
- A GitHub Action can publish an updated specification on merge, and the Team plan lists PR comments showing breaking changes.apinotes.io · read 30 Sep 2026
- Interactive docs
- Generated docs include endpoint parameters, response schemas, code examples in 10+ programming languages, and a built-in Try-It-Now console.apinotes.io · read 30 Sep 2026
- Other import integrations
- Postman, Bruno, and Insomnia integrations are marked “Coming soon.”apinotes.io · read 30 Sep 2026
- 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.apinotes.io · read 30 Sep 2026
- Publishing workflow
- Users can paste, upload, or link a specification and publish documentation at an ApiNotes subdomain in under 60 seconds.apinotes.io · read 30 Sep 2026
- 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.apinotes.io · read 30 Sep 2026
- 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.apinotes.io · read 30 Sep 2026
- Support and custom plans
- The pricing page invites users who need a custom plan to contact ApiNotes.apinotes.io · read 30 Sep 2026
- Supported specifications
- The site lists full support for OpenAPI 3.0, 3.1, 3.2, and Swagger 2.0 specifications in YAML or JSON.apinotes.io · read 30 Sep 2026
- Team plan trial
- The Team plan includes a 14-day free trial and says no credit card is needed.apinotes.io · read 30 Sep 2026
- What it does
- ApiNotes turns OpenAPI or Swagger specifications into hosted interactive documentation and an automatically generated changelog with breaking-change alerts.apinotes.io · read 30 Sep 2026
