ApiNotes
ApiNotes turns OpenAPI and Swagger specifications into hosted interactive documentation and generates changelogs with alerts for breaking changes.
What ApiNotes is
ApiNotes turns OpenAPI and Swagger specifications into hosted interactive documentation and generates changelogs with alerts for breaking changes. It supports OpenAPI 3.0, 3.1, and 3.2, along with Swagger 2.0, in YAML or JSON. Generated references include endpoint parameters, response schemas, code examples in 10+ programming languages, and a built-in Try-It-Now console. Users can paste, upload, or link a specification and publish documentation on an ApiNotes subdomain. A GitHub Action can publish revisions when changes are merged; the Team plan also lists pull request comments about breaking changes. The free Starter plan supports one public API and the last 10 changelog releases, with up to 25 subscribers and one team member. Team costs $19 a month and includes five APIs, private documentation, full changelog history, unlimited subscribers, a custom domain, and five team members. Additional APIs are listed at £5/API. The Team plan includes a 14-day free trial with no credit card required. Postman, Bruno, and Insomnia integrations are marked as coming soon.
Good
- Supports OpenAPI 3.0, 3.1, and 3.2, plus Swagger 2.0.
- Generated docs include examples in 10+ programming languages.
- Try-It-Now console is built into documentation.
- GitHub Action can publish updates on merge.
- Team trial lasts 14 days without a credit card.
Watch out
- Starter is limited to one public API.
- Starter changelog retains the last 10 releases.
- Postman, Bruno, and Insomnia integrations are coming soon.
Who it suits
ApiNotes suits developers and teams publishing API references from OpenAPI or Swagger specifications. Starter may suit a single public API, while Team is aimed at groups that need private docs or multiple APIs.
Verdict
ApiNotes combines hosted API references with version changelogs and breaking-change alerts. The free tier is limited to a public API, while Team adds private documentation and expanded team capacity for $19 a month.
Plans and prices
From ApiNotes's own pricing page, checked 30 Sep 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Starter | Free | 1 API (public only) · 10-release changelog · up to 25 subscribers · 1 team member · unlimited validator/diff tools |
| Team | $19 a month | 5 APIs · full changelog history · unlimited subscribers · private docs · 25 guest readers · custom domain · 5 team members |
The facts
Each one read from ApiNotes's own pages, with the date it was checked.
What it does
- 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.checked 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.checked 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.checked 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.checked 30 Sep 2026
- Other import integrations
- Postman, Bruno, and Insomnia integrations are marked “Coming soon.”checked 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.checked 30 Sep 2026
- Publishing workflow
- Users can paste, upload, or link a specification and publish documentation at an ApiNotes subdomain in under 60 seconds.checked 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.checked 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.checked 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.checked 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.checked 30 Sep 2026
The company
- Data ownership
- The privacy policy says users retain full intellectual property rights to uploaded specifications, code, and generated documentation.checked 30 Sep 2026
Money
- Support and custom plans
- The pricing page invites users who need a custom plan to contact ApiNotes.checked 30 Sep 2026
- Team plan trial
- The Team plan includes a 14-day free trial and says no credit card is needed.checked 30 Sep 2026
