ApiNotes turns OpenAPI and Swagger specifications into hosted interactive API documentation and changelogs that flag breaking changes. It supports OpenAPI 3.0, 3.1, and 3.2, as well as Swagger 2.0, in YAML or JSON. Generated documentation can show 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 the documentation on an ApiNotes subdomain. A GitHub Action can publish updated specifications on merge; the Team plan also lists pull request comments about breaking changes. The free Starter plan supports one public API, retains the last 10 changelog releases, and allows up to 25 subscribers and one team member. Team costs 19.00 USD per month and includes five APIs, private docs, full changelog history, unlimited subscribers, a custom domain, and five team members. Additional APIs are listed at £5/API. Team has a 14-day trial with no credit card required. Postman, Bruno, and Insomnia integrations are marked as coming soon.
Who it is for
ApiNotes suits developers who publish API references from OpenAPI or Swagger specifications and want changelog tracking. The free plan fits a single public API; teams needing private docs or more APIs can consider Team.
What is good
- Supports OpenAPI 3.0, 3.1, 3.2, and Swagger 2.0.
- Generated docs include a Try-It-Now console.
- GitHub Action can publish updated specifications on merge.
- Team includes private documentation and a custom domain.
- Team trial lasts 14 days without a credit card.
What to know first
- Starter is limited to one public API.
- Starter retains only the last 10 changelog releases.
- Postman, Bruno, and Insomnia integrations are coming soon.
- Additional APIs are listed at £5/API.
Verdict
ApiNotes turns supported API specifications into hosted references with interactive features and breaking-change changelogs. Compare the Starter limits with Team’s 19.00 USD per month price and five-API allowance.
ApiNotes plans and pricing
All plansCompared on API documentation tools
- Free plan
- Yes
- Paid from
- $19/mo
- OpenAPI import
- Yes
- Interactive API reference
- Yes
- Code samples
- Yes
- API versioning
- Yes
- Custom domain
- Yes
- Hosting model
- hosted
