Get Advice Icon

Need advice about which tool to choose?Ask the StackShare community!


+ 1

+ 1
Add tool

Apiary vs What are the differences?

What is Apiary? Integrated API documentation, prototyping and testing. It takes more than a simple HTML page to thrill your API users. The right tools take weeks of development. Weeks that saves.

What is Beautiful documentation made easy. Collaborative Developer Hubs.

Apiary and can be primarily classified as "Documentation as a Service &" tools.

Some of the features offered by Apiary are:

  • Documentation- Organized around resources, code samples with syntax highlight, easy to explore.
  • Inspector- Users can make API calls through, we show them how they differ from documentation.
  • Community- Opensource your API documentation on GitHub. The right channel between developers on both side of the API.

On the other hand, provides the following key features:

  • Collaboration - Crowdsource your docs! Users can keep docs current by suggesting changes.
  • API Explorer - Let users play with your API right inside the documentation.
  • GitHub Sync - Keep auto-generated reference docs synced with your actual code.

"Easy to use" is the primary reason why developers consider Apiary over the competitors, whereas "Great UI" was stated as the key factor in picking

Sellsuki, TestLegends, and Frank and Oak are some of the popular companies that use Apiary, whereas is used by UNION,, and Codacy. Apiary has a broader approval, being mentioned in 43 company stacks & 19 developers stacks; compared to, which is listed in 33 company stacks and 4 developer stacks.

- No public GitHub repository available -
- No public GitHub repository available -

What is Apiary?

It takes more than a simple HTML page to thrill your API users. The right tools take weeks of development. Weeks that saves.

What is

Collaborative Developer Hubs
Get Advice Icon

Need advice about which tool to choose?Ask the StackShare community!

Why do developers choose Apiary?
Why do developers choose

Sign up to add, upvote and see more prosMake informed product decisions

    Be the first to leave a con

    Sign up to add, upvote and see more consMake informed product decisions

    What companies use Apiary?
    What companies use

    Sign up to get full access to all the companiesMake informed product decisions

    What tools integrate with Apiary?
    What tools integrate with
    What are some alternatives to Apiary and
    API management, design, analytics, and security are at the heart of modern digital architecture. The Apigee intelligent API platform is a complete solution for moving business to the digital world.
    It is the only complete API development environment, used by nearly five million developers and more than 100,000 companies worldwide.
    Swagger UI
    Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API
    JSDoc 3 is an API documentation generator for JavaScript, similar to JavaDoc or PHPDoc. You add documentation comments directly to your source code, right along side the code itself. The JSDoc Tool will scan your source code, and generate a complete HTML documentation website for you.
    It is a modern documentation platform where teams can document everything from products, to APIs and internal knowledge-bases. It is a place to think and track ideas for you & your team.
    See all alternatives
    Decisions about Apiary and
    Todd Gardner
    Todd Gardner
    President at TrackJS · | 4 upvotes · 287.9K views
    GitHub Pages
    GitHub Pages
    Read the Docs
    Read the Docs

    We recently needed to rebuild our documentation site, currently built using Jekyll hosted on GitHub Pages. We wanted to update the content and refresh the style to make it easier to find answers.

    We considered hosted services that could accept our markdown content, like and Read the Docs, however both seemed expensive for essentially hosting the same platform we already had for free.

    I also looked at the Gatsby Static Site generator to modernize Jekyll. I don't think this is a fit, as our documentation is relatively simple and relies heavily on Markdown. Jekyll excels at Markdown, while Gatsby seemed to struggle with it.

    We chose to stick with the current platform and just refresh our template and style with some add-on JavaScript.

    See more
    Noah Zoschke
    Noah Zoschke
    Engineering Manager at Segment · | 29 upvotes · 385.7K views
    Swagger UI
    Swagger UI

    We just launched the Segment Config API (try it out for yourself here) — a set of public REST APIs that enable you to manage your Segment configuration. A public API is only as good as its #documentation. For the API reference doc we are using Postman.

    Postman is an “API development environment”. You download the desktop app, and build API requests by URL and payload. Over time you can build up a set of requests and organize them into a “Postman Collection”. You can generalize a collection with “collection variables”. This allows you to parameterize things like username, password and workspace_name so a user can fill their own values in before making an API call. This makes it possible to use Postman for one-off API tasks instead of writing code.

    Then you can add Markdown content to the entire collection, a folder of related methods, and/or every API method to explain how the APIs work. You can publish a collection and easily share it with a URL.

    This turns Postman from a personal #API utility to full-blown public interactive API documentation. The result is a great looking web page with all the API calls, docs and sample requests and responses in one place. Check out the results here.

    Postman’s powers don’t end here. You can automate Postman with “test scripts” and have it periodically run a collection scripts as “monitors”. We now have #QA around all the APIs in public docs to make sure they are always correct

    Along the way we tried other techniques for documenting APIs like or Swagger UI. These required a lot of effort to customize.

    Writing and maintaining a Postman collection takes some work, but the resulting documentation site, interactivity and API testing tools are well worth it.

    See more
    Interest over time
    Reviews of Apiary and

    I cannot stress enough how important it is for companies to avoid

    There is no accountability from their team when their service encounters serious errors. For weeks now, the service has been throwing internal server errors which were caught by monitoring tools.

    In reaching out to support, the only information they ever gave was "Thank you" and a link to their status page. The status page does not reflect the fact the services is severely depredated and any further attempts over the past 14 days to reach support have been met with total silence.

    Then there was an exchange with their CEO on Twitter who seemed like they may try to get us some sort of response or RFO, but that has also been met with silence after submitting exactly what was requested.

    If you value the ability for your customers to reach your API Documents, then do not use



    A pretty UI and the right combination of tools (tutorial section, API documentation, announcements) does not make up for consistently slow and buggy experience. As the amount of stored documentation grows, the app becomes more and more unreliable about saving changes, and for complex, in-depth documentation, the anchor tagging system is terrible, leading to false redirects. Multiple times, I have lost everything I've worked on, and the support service is terrible, even at the enterprise level. Other times, my changes are being saved, even though the app tells me they are not. I do not recommend this service for any company with lots of documentation.

    How developers use Apiary and
    Avatar of Onezino Gabriel
    Onezino Gabriel uses ApiaryApiary

    Apiary é um excelente ferramente para documentação de sua API e guia para desenvolvimento do back-end. Utilizamos ele para garantir a informação correta a cada end-point.

    Avatar of uses

    Used for + open source documentation of Cast.

    Avatar of Flutter Health Inc.
    Flutter Health Inc. uses ApiaryApiary

    We use Apiary for adding and updating the API specification.

    Avatar of Chris Hartwig
    Chris Hartwig uses ApiaryApiary

    Used to document all our REST APIs

    How much does Apiary cost?
    How much does cost?
    Pricing unavailable