Add tool

Apiary vs ReadMe.io: 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 apiary.io saves.

What is ReadMe.io? Beautiful documentation made easy. Collaborative Developer Hubs.

Apiary and ReadMe.io 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 apiary.io, 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, ReadMe.io 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 ReadMe.io.

Sellsuki, TestLegends, and Frank and Oak are some of the popular companies that use Apiary, whereas ReadMe.io is used by UNION, ReadMe.io, and Codacy. Apiary has a broader approval, being mentioned in 43 company stacks & 19 developers stacks; compared to ReadMe.io, 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 apiary.io saves.

What is ReadMe.io?

Collaborative Developer Hubs

Want advice about which of these to choose?Ask the StackShare community!

Why do developers choose Apiary?
Why do developers choose ReadMe.io?

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

What are the cons of using Apiary?
What are the cons of using ReadMe.io?
    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 ReadMe.io?

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

    What tools integrate with Apiary?
    What tools integrate with ReadMe.io?
    What are some alternatives to Apiary and ReadMe.io?
    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.
    Postman 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.
    Read the Docs
    Read the Docs hosts documentation, making it fully searchable and easy to find. You can import your docs using any major version control system, including Mercurial, Git, Subversion, and Bazaar. We support webhooks so your docs get built when you commit code. There's also support for versioning so you can build docs from tags and branches of your code in your repository.
    See all alternatives
    Decisions about Apiary and ReadMe.io
    No stack decisions found
    Interest over time
    Reviews of Apiary and ReadMe.io
    Review ofReadMe.ioReadMe.io

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

    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 readme.io 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 readme.io.


    Review ofReadMe.ioReadMe.io

    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 ReadMe.io
    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 SHOUTca.st
    SHOUTca.st uses ReadMe.ioReadMe.io

    Used for docs.shoutca.st + 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 ReadMe.io cost?
    Pricing unavailable