Apiary vs ApiNotes

Apiary is a hosted web platform for designing, documenting, prototyping, and testing APIs. Its editor supports API Blueprint and OpenAPI (Swagger), with instant validation and a live preview as descriptions are written. Publishing a description creates a mock server that returns the responses specified in it; the default limit is 120 requests per minute, or 5,000 with authentication. Automated tests compare real API responses with expectations generated from the description. Apiary also supports OpenAPI import, interactive references, code samples, and API versioning. Teams can manage document access with Admin, Editor, and Viewer roles, and sync with GitHub. Branch-based GitHub integration is available on Pro. The free plan costs nothing and permits unlimited API projects and five participants per project, but projects are public and teams are not included. Standard and Pro are deprecated, with plan changes handled by support request for current customers. Embedding interactive documentation is supported on Standard and Pro.

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.