- Home
- API Documentation Tools
- Apiary
Apiary
What it is
Apiary is a hosted web platform for designing, prototyping, documenting, and testing APIs. It supports API Blueprint and OpenAPI (Swagger) descriptions, and its editor validates API descriptions as you work while showing a live preview. Publishing a description creates a mock server that returns the responses it defines. Automated testing compares an API’s actual responses with expectations based on that description. Teams can set Admin, Editor, and Viewer roles to manage access to API documents. Apiary also supports OpenAPI import, interactive API references, code samples, API versioning, and embedding documentation in websites or internal portals on Standard and Pro plans. GitHub sync is available, with branch-based integration listed for Pro. The free plan costs nothing and includes unlimited API projects, five participants per project, public projects, and no team. Standard and Pro are marked deprecated; current customers must request plan changes through support. The mock server allows 120 requests per minute by default, or 5,000 with authentication.
For and against
For
- Supports API Blueprint and OpenAPI descriptions.
- Publishes mock servers from API descriptions.
- Automated tests compare responses with expectations.
- Free plan includes unlimited API projects.
- Roles control access to API documents.
Against
- Free projects are public and have no team.
- Free plan allows five participants per project.
- Standard and Pro are deprecated.
- Mock server defaults to 120 requests per minute.
The verdict
Apiary combines API design, documentation, mock responses, and testing in a hosted platform. Its free plan has clear project and participant terms, while deprecated paid plans and their support-managed changes are important considerations for teams.
Who it suits
Apiary suits individuals or small groups designing and documenting APIs, particularly those who can work with public projects and up to five participants on the free plan. Teams needing private projects, embedding, or expanded collaboration should note that Standard and Pro are deprecated.
Plans and prices
Free
Unlimited API projects · 5 participants per project · no team · public projects
Read 2 Oct 2026 · apiary.io
Pro
Deprecated · custom collaborators · advanced GitHub integration · priority support
Read 2 Oct 2026 · apiary.io
Standard
Deprecated · 10 participants per project · private projects · team management
Read 2 Oct 2026 · apiary.io
On the record
- Automated testing
- Automated testing compares an API’s actual responses with expectations generated from its API description.help.apiary.io · read 2 Oct 2026
- Description formats
- Apiary supports API Blueprint and OpenAPI (Swagger) API description formats.apiary.io · read 2 Oct 2026
- Editor
- The editor provides instant validation and a live preview for API descriptions.help.apiary.io · read 2 Oct 2026
- Embed documentation
- Apiary supports embedding interactive documentation in websites or internal portals on Standard and Pro plans.apiary.io · read 2 Oct 2026
- Integrations
- Apiary offers GitHub sync, with branch based GitHub integration available on Pro according to its help page.help.apiary.io · read 2 Oct 2026
- Mock server
- Publishing an API description automatically creates a mock server that returns responses defined in the description.help.apiary.io · read 2 Oct 2026
- Mock server limit
- The mock server allows 120 requests per minute by default and 5,000 requests per minute with authentication.help.apiary.io · read 2 Oct 2026
- Ownership
- Oracle announced its agreement to acquire Apiary in January 2017.oracle.com · read 2 Oct 2026
- Plan status
- The pricing table labels Standard and Pro as deprecated and says plan changes are handled by support request for current customers.apiary.io · read 2 Oct 2026
- Product purpose
- Apiary is a web based platform for designing, prototyping, documenting, and testing APIs.apiary.io · read 2 Oct 2026
- Support
- Pro includes priority support with guaranteed 24x7 response times from a dedicated support team.apiary.io · read 2 Oct 2026
- Team controls
- Teams can assign Admin, Editor, and Viewer roles and control access to API documents.apiary.io · read 2 Oct 2026
- Viewer limit
- Viewers of private API projects are capped at 50 on Standard, and the limit can be raised on custom Pro plans.apiary.io · read 2 Oct 2026
