Most API teams stopped hand-writing their reference docs years ago. Point a tool at an OpenAPI file and it renders the endpoint list, the schemas and a try-it console for you, which is exactly why it's strange that Postman's 2025 State of the API Report (5,700+ respondents, published August 2025) still found 55% of API teams fighting inconsistent, outdated or missing documentation. The spec is accurate. The docs still aren't. I went through pricing pages for six platforms to see why, and wrote a longer version of the breakdown on DevToolLab if you want every screenshot and the full per-tool rundown.
The workflow every tool here assumes
Same report: 60% of teams version their APIs, 57% keep specs in Git, and 41% now use AI somewhere in the docs pipeline (enough that Postman folded a generator called Fern into its own product). None of that changes what has to happen next - a spec still needs a tool to turn it into a browsable site with search, versioning, and usually a domain that doesn't say the vendor's name on it.
The gate that's easy to miss
Every platform below gives you a custom domain cheaply or free. What's gated separately, and priced very differently, is removing the vendor's own branding entirely.
| Platform | Custom domain from | Branding removal |
|---|---|---|
| Mintlify | $0/month | Enterprise only, custom price |
| ReadMe | $0/month | Enterprise only, custom price |
| Stoplight | $113/month (annual) | $362/month (annual) tier |
| Redocly | $10/seat/month | not gated separately |
| Scalar | $0/month | not gated separately |
| Swagger UI | self-hosted | no vendor mark to begin with |
Stoplight is the most upfront about it: Basic and Startup get domains and theming, but "Remove Stoplight branding" doesn't show up until Pro Team at $362/month billed annually. If "our logo, not theirs" is a hard requirement, that's the number to plan around, not the entry-tier price everyone quotes.
Six platforms, six pricing models
Mintlify is the fastest to stand up: point it at a GitHub repo and an openapi.yaml, and you get API reference, search and an in-browser playground in minutes, no build step. It also runs an AI layer that flags pages drifting out of sync with the spec. Free Starter caps at 5 editor seats; Pro is $450/month with unlimited seats and 10,000 AI credits (then $0.01/credit).
ReadMe is a full docs CMS wrapped around the API reference, and its editor can push changes back into your source repo, not just read from it. The catch is one project per plan below Enterprise, so two APIs need two subscriptions. Pro is $250/month annual.
Stoplight, a SmartBear product since 2022, leans into the design side: a visual OpenAPI editor plus shared style guides across up to 20 teams on Pro Team. Free is one user, one project; extra editors cost $11-27/month on top of whichever tier you're on.
Redocly sells hosting and a catalog layer on top of Redoc, the open-source renderer that clears 1M npm downloads/week (MIT, v2.5.3, 25,927 GitHub stars). Pro is metered: $10/seat/month, capped at 100 pages before you need the next tier.
Scalar is the one that's genuinely self-hostable start to finish - MIT core, 16,197 stars, shipped a release as recently as September 25, 2026. Run the reference UI and API client free forever; pay only for hosting, SDK generation or their MCP server output. Free stops at 3 APIs; Business tops out at 25.
Swagger UI is still the baseline everyone else gets compared to: Apache 2.0, 29,026 stars, no account or seat count because there's no hosted product at all. It renders one spec into one page and leaves hosting to you. If you just want to paste a spec and look at it without deploying anything, DevToolLab's Swagger Viewer does that same job in the browser.
Picking without migrating twice
A few things worth checking before you commit:
- Count specs, not headcount. Redocly and Scalar price on distinct APIs and page counts, not seats, so match your real spec count against their tier tables.
- Decide on branding removal up front. If zero third-party logo is non-negotiable, price Mintlify/ReadMe Enterprise or Stoplight's $362 tier now, not after launch.
- Try the free renderer first. Paste your spec into Swagger UI or Scalar's open core - if it looks fine, the paid tier is selling hosting and search, not the rendering itself.
- Match sync direction to who edits docs. ReadMe's bi-directional editing solves "writer fixes a typo without a PR." Mintlify's drift detection solves "spec and page disagree." Different problems.
The original post has the full side-by-side table (model, cheapest paid tier, self-host status, license) and a use-case breakdown for five different team shapes, plus the sourcing for every GitHub star count and release date above.
Bottom line
Turning an OpenAPI file into a readable page has been free for years, through Swagger UI and now Scalar's open core. What the current crop of paid platforms sells is what happens around that page - AI drift detection, bi-directional editing, multi-team governance, and a domain with nobody else's logo on it. Check which of those your subscription actually includes before renewing.
Top comments (0)