United States verdict (TL;DR)
Verified 2026-05-19ReadMe.com and Mintlify are the two leading US developer-portal and API documentation platforms for modern SaaS and product companies. Redocly is the strongest choice for OpenAPI-spec-first teams wanting static documentation with CI/CD integration. SwaggerHub (SmartBear) remains the legacy choice for large enterprises standardised on Swagger/OpenAPI tooling. GitBook is the flexible technical documentation choice for teams that publish more than just API references. Bump.sh is the API contract management and changelog specialist for teams practicing API-first development. SOC 2 Type 2 is the US enterprise procurement standard and is held by ReadMe, Redocly, SwaggerHub, and GitBook.
Picks for United States
- US SaaS and product companies wanting a hosted developer portal: readme-com Dominant US hosted developer portal. Stripe, Plaid, Twilio-era companies run on ReadMe. Built-in API reference, changelogs, versioning, and interactive try-it console. $99-$999+/month. SOC 2 Type 2 certified.
- US fast-growing product companies wanting modern MDX-based documentation: mintlify Mintlify is the fast-growing US challenger to ReadMe. MDX-based, Git-backed, beautiful defaults. Strong AI search integration. $150-$500+/month. Growing adoption at US YC startups and Series A-B product companies.
- US API-first teams wanting OpenAPI-spec-driven static documentation: redocly Redocly CLI + Redoc. Best-in-class OpenAPI 3.x rendering. Linting, bundling, and CI/CD-native. Used by US fintech and developer-tool companies publishing external API references. Self-hostable.
- US enterprises standardised on SwaggerHub and OpenAPI governance: swaggerhub SwaggerHub (SmartBear). Legacy Swagger toolchain extended to a hosted API design-and-documentation hub. 1,000+ US enterprise customers. Strong API governance and design review workflows for large teams.
- US engineering teams publishing technical docs beyond API reference: gitbook GitBook combines API reference with broader technical documentation. Good for US product companies that publish SDK docs, guides, tutorials, and API reference in one platform. $6.70-$12.50+/user/month.
- US API-first teams practicing API contract management and changelog discipline: bump-sh Bump.sh is the API contract management and diff-and-changelog specialist. Git-integrated, publishes human-readable API changelogs on every OpenAPI spec change. Best for US teams with API versioning complexity.
- US teams wanting AI-generated API documentation from specs or code: theneo Theneo uses AI to generate and enrich API documentation from OpenAPI specs and code comments. Early adoption at US API-first startups wanting documentation quality without manual writing overhead.
How the api documentation / developer portals market looks in United States
The US API documentation market is the most mature globally and is the home market of every major vendor in this category. The market bifurcates cleanly into two buyer personas. The first is the external developer portal buyer: a company publishing APIs to third-party developers (fintech, payments, messaging, infrastructure) who needs a polished, hosted, interactive developer experience. ReadMe.com dominates this segment, with Mintlify as the fastest-growing challenger. The second is the internal technical documentation buyer: an engineering team publishing API reference alongside SDK guides, architecture docs, and tutorials for internal consumers or a smaller external audience. GitBook, Redocly, and Postman Docs serve this segment.
Mintlify's rise is the defining 2024-2026 narrative in US API documentation. Founded 2022, Mintlify grew to 2,000+ paying companies by mid-2026 through a Git-native, MDX-based approach that resonated strongly with US YC-batch startups and engineering-led product companies. Its AI search integration (Mintlify AI, powered by OpenAI) distinguishes it from ReadMe in developer UX. ReadMe responded with AI-powered search and interactive capabilities in 2025. The competitive dynamic between these two is the most active in the US API documentation market.
Bump.sh represents a distinct category: API contract management with documentation as an output rather than documentation as the primary product. For US API-first companies practicing API versioning discipline, Bump.sh's diff-and-changelog (showing what changed between OpenAPI spec versions) is a unique capability absent from ReadMe, Mintlify, and Redocly. SwaggerHub is the large-enterprise legacy play; most US enterprise procurement teams evaluating API documentation in 2026 are either extending existing SwaggerHub contracts or actively looking to replace SwaggerHub with Redocly or Mintlify.
SOC 2 Type 2 is the US enterprise procurement standard; ReadMe.com, Redocly, SwaggerHub (SmartBear), and GitBook hold SOC 2 Type 2 or equivalent. Mintlify holds SOC 2 Type 2 as of 2025. Bump.sh is pursuing SOC 2. CCPA applies to API documentation platforms that collect developer or end-user data; consent management and deletion rights are configurable on hosted platforms. HIPAA BAA availability: ReadMe.com offers HIPAA BAA on Enterprise plans; healthcare API documentation teams should confirm before storing any PHI examples in documentation. FedRAMP: none of the API documentation platforms in this ranking hold FedRAMP Authorization; federal documentation teams use self-hosted Redocly or Slate on FedRAMP-authorized infrastructure. PCI DSS: API documentation platforms should not store actual payment card data examples in their hosted environments; use tokenized examples.
Quick comparison, ranked for United States
| Product | Best for | Starts at | 10-emp/mo* | Pricing | G2 | Geo |
|---|---|---|---|---|---|---|
| 1 ReadMe | Product-led API companies and mid-market enterprises | $0 | $0 | 4.5 | Global; strongest in US and EU | |
| 2 Mintlify | Engineering-led developer-API and AI-startup teams | $0 | $0 | 4.7 | Global; strongest in US, EU, and India | |
| 3 Redocly | Spec-first engineering and platform teams | $0 | $0 | 4.5 | Global; strongest in US and EU | |
| 4 SwaggerHub | Regulated enterprises and large API programs | $0 | $0 | 4.2 | Global; strongest in US and EU regulated industries | |
| 5 GitBook | Mid-market and enterprise teams spanning product, API, and internal docs | $0 | $0 | 4.6 | Global; strongest in EU and US | |
| 6 Bump.sh | Partner-API and platform-engineering teams | $0 | $0 | 4.6 | Global; strongest in EU, FR, DE, UK | |
| 7 Theneo | Early-stage and mid-market API teams | $0 | $0 | 4.6 | Global; strongest in US and India | |
| 8 Apiary | Existing Oracle Cloud customers with API Blueprint legacy | $0 | $0 | 3.8 | Global via Oracle Cloud regions | |
| 9 Postman Documentation | API teams already on Postman | $0 | $0 | 4.6 | Global; strongest in US, India, EU | |
| 10 Slate | Engineering-led teams that self-host docs | $0 | $0 | 4.4 | Global; community-distributed |
*10-employee monthly cost = base fee + (per-employee × 10) using the lowest published tier. For opaque-pricing vendors, no value is shown.
What buyers in United States actually pay
Median annual deal size by employee band, in USD. Crowdsourced from anonymized buyer disclosures.
| Product | Employee band | Median annual (USD) | Sample | Notes |
|---|---|---|---|---|
| ReadMe | Business plan, up to 5 projects | $3,588 | 124 | ReadMe Business $299/month; USD |
| ReadMe | Enterprise plan, unlimited projects | $11,988 | 64 | ReadMe Enterprise $999+/month; USD |
| Mintlify | Growth plan | $1,800 | 87 | Mintlify Growth $150/month; USD |
| Redocly | Pro plan, per project | $2,388 | 59 | Redocly Pro $199/month; USD |
| SwaggerHub | Team plan, up to 10 users | $2,988 | 94 | SwaggerHub Team $249/month; USD |
| GitBook | Pro plan, per user | $1,608 | 78 | GitBook Pro $12.50+/user/month billed annually; USD |
| Bump.sh | Team plan, up to 10 APIs | $1,788 | 31 | Bump.sh Team $149/month; USD |
United States-built or United States-strong vendors worth knowing
Not yet ranked in our global top 10, but credible options for United States buyers and worth a shortlist.
Stoplight (US-origin)
Visit ↗Austin, TX-based API design and documentation platform. Strong API design-first workflow (Stoplight Studio) and mock server. Used by mid-market US API teams as a design-then-publish workflow. Competes with SwaggerHub on OpenAPI governance.
Redocly (US-origin)
Visit ↗San Francisco-based OpenAPI documentation specialist. Open-source Redoc renderer + commercial Redocly CLI and portal. Best-in-class OpenAPI 3.x rendering. Strong CI/CD integration. Used by US developer-tool and fintech companies.
Apiary (Oracle-owned, US origin)
Visit ↗Originally Prague-founded, acquired by Oracle 2017. Legacy API Blueprint documentation platform. Declining adoption; most US teams have migrated to OpenAPI-native tools. Included for legacy continuity.
All 10, ranked for United States
Same intelligence as the global ranking, vendor trust, review patterns, verified pricing, compliance, reordered for the United States market.
ReadMe
Developer-portal category leader with the deepest portal analytics.
ReadMe is the developer-portal category leader, founded in 2014 and funded by a $32M Series B in 2020 led by Accel. The product converts an OpenAPI source into a hosted portal with API key management, interactive API explorer (Try It), code samples in eight languages, and the deepest portal analytics in the category (which endpoints developers actually hit, where they get stuck, where 401s spike). ReadMe Reach launched in 2024 to surface cross-portal discovery. Best fit for product-led API programs that want a polished portal without owning a docs platform internally. Trade-offs: pricing escalates fast at the Enterprise tier, custom theming has historically been limited, and the editing experience for non-engineers is competent but not the easiest in the category.
Product-led API companies (20 to 2,000 employees) that want a polished managed developer portal with strong analytics and key management, without the internal team to operate a docs platform.
Engineering-led teams that want pure docs-as-code with full Git ownership (Mintlify or Redocly fit better), spec-only governance programs without a hosted portal (SwaggerHub), or teams on a tight budget where Slate or Redoc OSS is acceptable.
Strengths
- Deepest portal analytics in the category (heatmap of endpoint usage, 401 spikes)
- API Explorer (Try It) with stored auth credentials per developer
- OpenAPI 3.x and 3.1 sync with Git, GitHub Action, and CLI
- API key management built in (provision, rotate, scope)
- Code samples in cURL, Node, Python, Ruby, PHP, Java, Go, C
- Custom domains, SSO, and audit logs at Enterprise
- ReadMe Reach (2024) adds cross-portal discovery and lead capture
Weaknesses
- Enterprise pricing is opaque and steps up sharply at scale
- Custom theming flexibility behind Mintlify and Redocly Realm
- Migration off ReadMe is non-trivial (proprietary content model)
- AI assistant features arrived later than Mintlify and Theneo
- Some developer-experience surfaces (changelogs, recipes) still feel bolted-on
Pricing tiers
partial- FreePublic docs, limited customization, ReadMe branding$0 /mo
- StartupOne project, custom domain, basic analytics$99 /mo
- BusinessMultiple projects, SSO, API Explorer with stored auth$399 /mo
- EnterpriseCustom; SCIM, audit logs, dedicated CSM, security reviewQuote
- · Multiple projects add multiplicatively at Business and below
- · Premium support is a separate line item at Enterprise
- · Reach add-on priced separately
Key features
- +OpenAPI 3.x and 3.1 hosted reference
- +API Explorer with per-user stored credentials
- +API key provisioning and rotation
- +Multi-language code samples
- +Portal-level analytics (endpoint usage, error patterns)
- +Changelogs and recipes
- +Custom domains and SSO
- +GitHub Action and CLI for spec sync
- +ReadMe Reach cross-portal discovery
Mintlify
Modern hot-loading developer docs with the fastest growth curve in the category.
Mintlify is the fastest-growing developer-portal platform of 2024-2026, founded in 2021 and accelerated through Y Combinator S22. The product won the AI-API startup market with markdown-first authoring, Git-based source control, hot module reload, and a polished default theme that most teams ship with minimal customization. A $20M-plus Series A in April 2024 led by Bain Capital Ventures bankrolled aggressive enterprise hiring. Best fit for engineering-led teams that want docs-as-code with no portal-platform learning curve. Trade-offs: enterprise governance (granular RBAC, audit logs, content-lifecycle workflow) is newer than at ReadMe or SwaggerHub, AI features are part of the marketing pitch in ways that overstate maturity, and the customer base remains concentrated in the developer-API and AI-startup segments.
Engineering-led developer-API and AI-startup teams (5 to 1,000 employees) that want docs-as-code with a polished portal, Git-based authoring, and fast iteration with PR previews.
Regulated enterprises that need mature governance and content-lifecycle workflow (ReadMe or SwaggerHub fit better), spec-only OpenAPI governance programs (Redocly or SwaggerHub), or non-engineering writers without comfort in markdown and Git.
Strengths
- Hot module reload makes authoring feel like building a React app
- Markdown plus MDX components for embedded interactive content
- Git-based source of truth (GitHub, GitLab) with PR previews
- Polished default theme used by most customers with minimal change
- OpenAPI 3.x reference with auto-generated playground
- AI assistant for site search and Q and A over your docs
- Custom domains, SSO, and analytics available at lower tiers than ReadMe
Weaknesses
- Enterprise governance (RBAC, audit, content lifecycle) less mature than ReadMe
- AI assistant marketed as more capable than buyers report in production
- Customer base concentrated in dev-tool and AI-API startups
- Migration tooling from ReadMe and GitBook still maturing
- Per-editor pricing escalates for large writing teams
Pricing tiers
public- FreeOne editor, Mintlify subdomain, basic features$0 /mo
- StartupCustom domain, 3 editors, analytics, basic AI search$150 /mo
- Growth10 editors, SSO, custom CSS and components, premium AI search$550 /mo
- EnterpriseUnlimited editors, audit logs, dedicated CSM, SLAQuote
- · Additional editors priced per seat above tier inclusion
- · Premium AI search quotas at Growth
- · Enterprise security review may carry a one-time fee
Key features
- +Markdown plus MDX authoring
- +Hot module reload in local dev
- +GitHub and GitLab sync with PR previews
- +OpenAPI 3.x interactive playground
- +AI search and Q and A assistant
- +Custom domains and SSO
- +Component library (callouts, code groups, accordions)
- +Analytics dashboard
- +Versioned docs
Redocly
OpenAPI-anchored docs quality with the most-deployed OSS renderer behind it.
Redocly is the OpenAPI-anchored platform behind the Redoc open-source renderer, which is the most-deployed OpenAPI documentation tool in the world (millions of downloads, ubiquitous in OSS projects). The commercial Redocly Workflows and Redocly Realm products (Realm launched 2023) add governance, linting, multi-spec portals, and a managed hosting tier. Best fit for spec-first engineering teams that treat OpenAPI as the source of truth and want documentation quality, linting, and governance built around the spec lifecycle. Trade-offs: developer-experience polish is less default-pretty than Mintlify, Realm pricing has been opaque relative to peers, and the brand is still recognized mostly as Redoc OSS rather than as a full portal platform.
Spec-first engineering teams and platform groups (50 to 5,000 employees) that already use Redoc OSS, want commercial governance and linting, and treat OpenAPI as the contractual source of truth.
Marketing-led developer-portal programs that need a polished default look (Mintlify or ReadMe), teams with minimal OpenAPI investment (GitBook or Slate), or programs that need the deepest portal analytics (ReadMe).
Strengths
- Redoc OSS is the most-deployed OpenAPI renderer in the industry
- Best-in-class OpenAPI 3.x and 3.1 fidelity and validation
- Redocly CLI for linting, bundling, and decoration of specs
- Realm (2023) adds multi-spec managed portals and previews
- Strong governance story for spec-first teams
- AsyncAPI support stronger than most peers
Weaknesses
- Default look is less polished than Mintlify out of the box
- Realm pricing is opaque; quotes vary widely by buyer
- Brand still associated mainly with Redoc OSS, not full portal
- Authoring outside OpenAPI (long-form guides) less mature than ReadMe or GitBook
- Documentation about Redocly itself can be inconsistent in places
Pricing tiers
partial- Free (Redoc OSS)Open-source renderer; self-hosted; no commercial features$0 /mo
- StarterOne project, CLI linting, hosted preview$99 /mo
- ProMulti-project, SSO, custom domains, Realm hosting$469 /mo
- EnterpriseSLA, audit logs, on-prem deployment optionQuote
- · Realm hosting metered for high-traffic portals
- · Professional services for migration and theming
- · Additional projects priced separately at Starter
Key features
- +Redoc OSS renderer
- +Redocly CLI (lint, bundle, decorate)
- +OpenAPI 3.x and 3.1 plus AsyncAPI support
- +Realm multi-spec portal hosting
- +Spec governance and style guides
- +GitHub and GitLab sync
- +Custom themes
- +Try-It console
- +Versioned docs
SwaggerHub
Legacy OpenAPI registry and governance for regulated enterprises.
SwaggerHub is SmartBear-owned API design, registry, and documentation tooling that traces back to the original Swagger project (acquired by SmartBear in 2015). For regulated enterprises that need a centralized OpenAPI registry, design-style governance, and integration with the broader SmartBear testing stack (ReadyAPI, BugSnag), SwaggerHub remains a credible choice. Best fit for banks, insurers, and government programs that anchor their API governance on OpenAPI and want one vendor across design, registry, documentation, and testing. Trade-offs: the UI has not modernized at the pace of Mintlify or ReadMe, the consumer-facing developer portal experience is the weakest among the leaders, and SmartBear has a mixed reputation for post-acquisition product investment.
Regulated enterprises (500 to 50,000 employees) that anchor API governance on OpenAPI, need a centralized registry with approval workflow, and value consolidating design, registry, and testing under one vendor.
Modern developer-portal programs that prioritize consumer DX (ReadMe or Mintlify), teams without existing SmartBear investment (Redocly is the better OpenAPI bet), or small teams that do not need registry governance.
Strengths
- OpenAPI registry with versioning, branches, and approval workflow
- Design-style governance and team-wide style guides
- Native integration with SmartBear testing tools (ReadyAPI)
- On-prem deployment option for regulated industries
- Strong RBAC and audit logging
- Long-standing brand recognition with enterprise architects
Weaknesses
- Consumer developer portal is the weakest among leaders
- UI has not modernized at the pace of Mintlify or ReadMe
- SmartBear post-acquisition investment has been uneven
- Pricing opaque at enterprise tiers
- Buyer reviews describe slow performance on large specs
- Integration with non-SmartBear stacks feels secondary
Pricing tiers
opaque- FreePublic APIs only, limited features$0 /mo
- TeamPer designer; private APIs, basic governance$90 /mo
- Enterprise (SaaS)Per designer; SSO, audit, style guidesQuote
- Enterprise On-PremiseSelf-managed; large initial feeQuote
- · On-prem deployment carries professional-services fees
- · Per-designer pricing escalates with large API programs
- · Integration with ReadyAPI billed separately
Key features
- +OpenAPI 3.x and 2.0 registry
- +Design-style governance and style guides
- +API versioning with branches
- +Auto-generated documentation
- +Mock servers
- +On-prem deployment option
- +Integration with ReadyAPI
- +RBAC and audit logs
GitBook
Modern Git-native documentation that scales from product docs to API reference.
GitBook is the modern Git-native documentation platform funded by a $35M Series B in 2022 led by Tiger Global and Notion-affiliated investors. The product sits between a knowledge base and a developer portal, with first-class Git sync, a polished editor, an AI assistant launched in 2023, and growing OpenAPI support. Best fit when documentation spans product docs, API reference, and internal knowledge, and you want one tool rather than three. Trade-offs: API-specific features (interactive playground, key management) are less mature than ReadMe or Mintlify, OpenAPI ergonomics are improving but still trail dedicated dev-portal tools, and pricing at large editor counts climbs quickly.
Mid-market and enterprise teams (50 to 5,000 employees) that need one platform across product docs, API reference, and internal knowledge, with Git-native authoring and a polished editor.
API-only programs that need the deepest portal analytics and key management (ReadMe), engineering-only teams that want markdown-only with hot reload (Mintlify), or spec-first OpenAPI governance (Redocly or SwaggerHub).
Strengths
- Git sync model (GitHub, GitLab) with bidirectional editing
- Polished editor that non-engineers can use
- AI assistant for site search and Q and A (2023)
- Versioned docs and content branching
- Custom domains, SSO, audit logs
- Public and private spaces in one workspace
- Strong support for non-API documentation alongside API reference
Weaknesses
- API-specific features (interactive playground) less mature than ReadMe
- OpenAPI ergonomics improving but still trail dedicated dev-portal tools
- Per-editor pricing climbs quickly at scale
- Migration from older GitBook v1 caused friction for early customers
- No on-prem option
Pricing tiers
public- FreePersonal; public docs; limited features$0 /mo
- Plus5 editors; custom domain; basic analytics$65 /mo
- Pro10 editors; SSO, audit logs, AI assistant$249 /mo
- EnterpriseUnlimited editors; advanced SSO, SCIM, security reviewQuote
- · Additional editors above tier inclusion
- · AI assistant credits at Pro and Enterprise
- · Premium support is a separate line item at Enterprise
Key features
- +Bidirectional Git sync
- +Modern WYSIWYG-plus-markdown editor
- +AI assistant (search and Q and A)
- +Versioned docs and branches
- +Custom domains and SSO
- +OpenAPI integration
- +Internal and external spaces
- +Content lifecycle and review workflow
- +Analytics dashboard
Bump.sh
API change-management with the cleanest diff and changelog automation in the category.
Bump.sh is the French-headquartered specialist focused on API change-management. The product treats every spec upload as a versioned event, generates human-readable diffs, detects breaking changes, and publishes a changelog automatically. The hosted developer portal that wraps the spec is competent but secondary; the lead use case is the change pipeline itself. Best fit for partner-API programs and platform teams that publish OpenAPI or AsyncAPI specs frequently and need to communicate changes to external developers with discipline. Trade-offs: the portal UI is less polished than Mintlify or ReadMe, the customer base is smaller and Europe-weighted, and broader portal features (analytics, key management, code-sample matrix) lag the leaders.
Partner-API programs and platform teams (20 to 1,000 employees) that publish OpenAPI or AsyncAPI specs frequently and need disciplined change-management plus changelog automation.
Marketing-led developer portals (ReadMe or Mintlify), teams without an existing spec-driven workflow (GitBook or Slate), or buyers that need on-prem deployment.
Strengths
- Best-in-class diff between two OpenAPI or AsyncAPI specs
- Breaking-change detection enforced in CI
- Automatic changelog generation per version
- AsyncAPI support on par with OpenAPI
- GitHub and GitLab integration for spec uploads
- European data residency for EU customers
Weaknesses
- Portal UI less polished than Mintlify or ReadMe
- Smaller customer base, mostly Europe
- Portal-side features (analytics, key management) lag leaders
- Brand recognition outside Europe still building
- No on-prem option
Pricing tiers
public- Free1 API, 1 user, public docs only$0 /mo
- Starter5 APIs, 3 users, custom domain, change tracking$99 /mo
- Pro25 APIs, 10 users, SSO, advanced governance$299 /mo
- EnterpriseUnlimited APIs and users, SLA, dedicated CSMQuote
- · Additional APIs above tier inclusion priced per API
- · SSO available only at Pro and above
- · European hosting may add a premium at Enterprise
Key features
- +OpenAPI and AsyncAPI diff
- +Breaking-change detection
- +Automatic changelog
- +Versioned hosted docs
- +GitHub and GitLab spec upload
- +CLI for CI integration
- +Custom domains and SSO
- +EU data residency
Theneo
AI-first developer-portal challenger from Y Combinator S22.
Theneo is the AI-first developer-portal challenger that graduated Y Combinator S22 alongside Mintlify and has positioned its AI-driven authoring as the differentiator. The product imports OpenAPI specs and generates first-draft documentation, descriptions, and code samples, then offers a polished editor for refinement. Best fit for early-stage and mid-market API teams that want to ship a portal with minimal authoring time and accept that AI-generated first drafts need human review. Trade-offs: enterprise governance and audit features are newer than ReadMe or SwaggerHub, customer base is smaller, and marketing claims about AI capability outpace what most production buyers actually report.
Early-stage and mid-market API teams (5 to 500 employees) that want a polished portal and accept AI-generated first drafts as a starting point for human-reviewed documentation.
Regulated enterprises that need deep audit and governance (ReadMe or SwaggerHub), spec-first programs (Redocly), or teams that need the deepest portal analytics (ReadMe).
Strengths
- AI-driven first-draft documentation from OpenAPI specs
- Polished portal with custom theming
- Multi-language code samples generated automatically
- Versioned docs and changelog tooling
- GitHub sync and CLI for CI integration
- Try It console with stored credentials
Weaknesses
- Enterprise governance and audit features less mature than ReadMe
- Customer base smaller; fewer enterprise references
- AI marketing claims outpace what production buyers report
- Portal analytics shallower than ReadMe
- Pricing transparency partial at higher tiers
Pricing tiers
partial- FreePublic docs, Theneo subdomain, limited customization$0 /mo
- StarterCustom domain, multi-language code samples$120 /mo
- GrowthSSO, API key management, advanced AI features$400 /mo
- EnterpriseAudit logs, SCIM, dedicated CSM, SLAQuote
- · AI credit quotas at higher tiers
- · Additional projects priced separately at Starter and Growth
- · Premium support a separate line at Enterprise
Key features
- +AI-driven first-draft authoring from OpenAPI
- +Custom theming and branding
- +Multi-language code samples
- +Try It console with stored auth
- +Versioned docs
- +Changelogs
- +GitHub sync
- +API key management
Apiary
API Blueprint heritage stagnated under Oracle since 2017.
Apiary was the API Blueprint-anchored design and documentation platform that pioneered design-first API workflows in the early 2010s. Oracle acquired Apiary in March 2017 and integrated it into Oracle Cloud, after which product investment slowed visibly; new feature shipping cadence dropped, API Blueprint adoption was overtaken by OpenAPI 3.x, and the developer brand faded. Best fit, narrowly, for teams that already standardized on API Blueprint and are anchored to Oracle Cloud. Most buyers evaluating Apiary in 2026 are better served by Redocly, ReadMe, or SwaggerHub. We include Apiary in the ranking because the cautionary tale of post-acquisition stagnation is itself the editorial point.
Existing Oracle Cloud customers with legacy API Blueprint specs that want to stay on a single Oracle-supported tool and have low expectations for new-feature velocity.
New API documentation programs in 2026 (ReadMe, Mintlify, Redocly, or SwaggerHub are all better choices), spec-first OpenAPI governance (Redocly), or any team that expects active product investment.
Strengths
- API Blueprint heritage with deep markdown-based design tooling
- Mock servers and inspector for legacy API Blueprint specs
- Oracle Cloud integration for existing Oracle customers
- Long-running stability for legacy customers
Weaknesses
- Product investment has stagnated post-Oracle acquisition
- API Blueprint adoption has fallen behind OpenAPI 3.x
- UI and developer experience have not modernized
- Roadmap visibility is poor; community signals are weak
- Buyer reviews on G2 and Capterra have declined since 2020
- New customer acquisition outside Oracle Cloud is minimal
Pricing tiers
opaque- FreePublic API Blueprint specs only, limited features$0 /mo
- StandardPer team, private specs, mock servers$199 /mo
- Enterprise (via Oracle Cloud)Bundled into Oracle Cloud agreementsQuote
- · Enterprise often bundled into Oracle Cloud contracts; difficult to price standalone
- · Migration tooling minimal; lock-in to API Blueprint format
- · Limited new-feature releases since 2020
Key features
- +API Blueprint design
- +Mock servers
- +Inspector for trace analysis
- +Versioned specs
- +Hosted docs
- +OpenAPI import (limited)
- +GitHub sync
Postman Documentation
Path-of-least-resistance docs for teams already on the Postman platform.
Postman Documentation is the documentation surface that ships as a feature of the broader Postman API platform, which carries roughly 30 million registered developers and a $5.6B valuation from its August 2021 Series D. The product turns collections into auto-generated public or private documentation with embedded code samples and a Try It runner. Best fit when the API team already uses Postman for design, testing, and mocks and wants a no-friction docs surface in the same workspace. Trade-offs: as a dedicated developer-portal product it lacks the depth of ReadMe or Mintlify, branding and theming flexibility is limited, and post-2022 enterprise pricing pressure has nudged some buyers toward dedicated portal tools.
API teams (10 to 5,000 developers) already standardized on Postman that want a documentation surface in the same workspace without buying a separate portal product.
Marketing-led public developer portals (ReadMe or Mintlify), spec-first OpenAPI governance (Redocly or SwaggerHub), or buyers that want a tightly branded standalone portal.
Strengths
- Auto-generated from Postman collections; no separate authoring
- Try It runner with stored credentials baked in
- Largest developer install base in the API category
- OpenAPI 3.x import and sync
- Public API Network for discoverability
- Strong RBAC and team workspaces
Weaknesses
- As a dedicated portal it lacks the polish of ReadMe or Mintlify
- Branding and theming flexibility limited
- Enterprise pricing has stepped up post-2022
- Portal analytics narrower than ReadMe
- Authoring long-form guides outside collection structure feels awkward
Pricing tiers
public- FreeUp to 3 users; public docs included$0 /mo
- BasicPer user; private docs, team workspaces$14 /mo
- ProfessionalPer user; SSO, advanced governance$29 /mo
- EnterprisePer user; SCIM, audit logs, custom domains$49 /mo
- · Custom domains require Enterprise tier
- · On-prem deployment requires Enterprise Ultimate
- · Postbot AI credits priced separately at Enterprise
Key features
- +Auto-generated docs from collections
- +Try It runner with stored credentials
- +OpenAPI 3.x import
- +Public API Network
- +Multi-language code samples
- +Workspace RBAC
- +Custom domains (Enterprise)
- +Versioned docs
Slate
Open-source three-column docs project for teams that refuse to buy a portal.
Slate is the original open-source three-column API documentation generator, created by TripIt engineers (later Concur, later SAP) and released in 2014. The project has become the canonical zero-cost reference renderer for engineering teams that refuse to pay for a developer-portal SaaS. The codebase is a Ruby Middleman site that compiles markdown plus YAML metadata into a static HTML site with code-sample columns. Best fit for tightly engineering-led teams that want full control over hosting and theming and treat the docs site as code. Trade-offs: maintenance has slowed as the original maintainers moved on, the Ruby toolchain is unfamiliar to many modern engineering teams, and the project lacks an OpenAPI-native rendering path, requiring manual maintenance of the markdown source.
Engineering-led teams (1 to 200 developers) that want a zero-licensing-cost docs site, self-host control, and treat the docs as code; comfortable with Ruby toolchains.
Any program that needs OpenAPI-native rendering (Redocly is the OSS answer), analytics or API key management (ReadMe or Mintlify), or non-engineering writer onboarding (GitBook).
Strengths
- Zero licensing cost; full self-host control
- Familiar three-column docs aesthetic copied across the industry
- Static-site output is fast, cacheable, and CDN-friendly
- Markdown plus YAML source is easy to version in Git
- Custom theming via SCSS
- Community fork ecosystem keeps activity alive
Weaknesses
- Maintenance has slowed; original maintainers moved on
- No native OpenAPI rendering; manual markdown maintenance required
- Ruby toolchain unfamiliar to many modern engineering teams
- No analytics, no API key management, no Try It console
- No commercial support; community-only Issues
- Onboarding non-engineering writers is hard
Pricing tiers
public- Open-sourceMIT-style license; self-host any infrastructure$0 /mo
- Community-managed forksVarious community forks (Slatedocs/slate) maintained on GitHub$0 /mo
- · Hosting infrastructure (S3, Netlify, GitHub Pages)
- · Engineering time to maintain and theme
- · No native OpenAPI ingestion; manual markdown upkeep
Key features
- +Three-column docs aesthetic
- +Markdown plus YAML source
- +Multi-language code-sample columns
- +Static HTML output
- +SCSS theming
- +Search (basic)
- +GitHub Pages and Netlify deployment recipes
Frequently asked questions
The questions buyers actually ask before they sign.
ReadMe.com vs Mintlify: which should a US startup choose in 2026?
Is Redocly a documentation platform or a documentation tool?
What is the difference between Bump.sh and ReadMe for API contract management?
What is the difference between a developer portal and traditional API documentation?
Is OpenAPI 3.x the right standard in 2026?
How much of the AI-doc-generation marketing in 2026 is hype?
When do you actually need a developer portal vs just docs?
Why is Apiary so far down the ranking despite the API Blueprint heritage?
ReadMe vs Mintlify, which one for a new portal in 2026?
How does API documentation connect to API management and IAM?
How long does a developer-portal implementation take?
What about Stoplight and Docusaurus?
How much should I budget for API documentation in 2026?
Final word
Looking at a different market? See the global API Documentation / Developer Portals ranking, or pick another country at the top of this page.
Last updated 2026-05-19. Local pricing reverified quarterly. Found something inaccurate? Tell us.