emerging · -1.9 capability actionschema

API Design

Score 20.3 / 100 40 providers +2 via APIs 23 APIs Search apis.io →

Providers using this tag (39)

Ranked by API Evangelist rating — Exemplar and Strong are expanded by default.

Exemplar 2 Complete, well-documented, and agent-ready
Strong 2 Solid coverage with minor gaps
Developing 7 Usable, with meaningful gaps to close
Thin 7 Limited public surface area
Emerging 16 Early or largely undocumented
Minimal 5 Almost no public developer surface

APIs with this tag (23)

Ranked by the provider's API Evangelist rating — the Kin Score is scored per provider, not per API, so every API of a provider shares its band. How the rating works →

Exemplar 2 Complete, well-documented, and agent-ready
Strong 1 Solid coverage with minor gaps
Developing 3 Usable, with meaningful gaps to close
Thin 3 Limited public surface area
Emerging 12 Early or largely undocumented
Smithy IDLThe Smithy Interface Definition Language (IDL) is a specification for defining API models using shapes and ...25.1APIwizAPIwiz is a low-code, end-to-end API management platform enabling the complete API lifecycle including desi...24.6SpectralSpectral is a flexible JSON/YAML linter and style guide enforcer with built-in support for OpenAPI (v3.1, v...20.5Header-Based VersioningHeader-based versioning passes the API version in a custom HTTP request header (e.g., API-Version: 2026-04-...17.4URI Path VersioningURI path versioning embeds the API version in the URL path, typically as the major version number (e.g., /v...17.4JSON:APIJSON:API is a specification for how a client should request that resources be fetched or modified, and how ...16.3OpenAPI SpecificationThe OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful APIs which allow...16.3SpecLynxStop wrestling with OpenAPI specs. SpecLynx OpenAPI Toolkit delivers the most effective way to author and m...15.3SpecLynx ApiDOMA unified semantic parsing engine that underpins all SpecLynx products. ApiDOM parses OpenAPI, AsyncAPI, Ar...15.3SpecLynx EditorA browser-based OpenAPI editor with real-time validation, smart autocompletion, and live preview. No instal...15.3SpecLynx Language ServiceAn LSP-compatible npm library (@speclynx/apidom-ls) providing 13 intelligent editing capabilities for API d...15.3SpecLynx OpenAPI ToolkitA VS Code extension providing semantic editing, real-time validation, linting, and live preview for OpenAPI...15.3
Minimal 2 Almost no public developer surface

Companies reaching this through an API (2)

These companies publish an API, specification or operation carrying “API Design” but do not classify their business under it. Listed unranked and kept out of the count above, because one tagged operation is not a statement about what a company does.

MuleSoft Red Hat

Score breakdown

Frequency
47.9
log-scaled weighted occurrences
Breadth
0.9
spread across providers
Quality lift
30.7
mean composite of providers using it
Cohesion
13.3
strength of nearest seed neighbor

Where this tag sits

Developer Tools broader

Related tags

API Lifecycle 6 co-occurrences API Testing 10 co-occurrences API Documentation 7 co-occurrences OpenAPI 21 co-occurrences JSON Schema 6 co-occurrences Mocking 5 co-occurrences API Governance 5 co-occurrences Specification 7 co-occurrences

Where this tag comes from

Provider tag40
Api tag23

Cohort brief

Auto-generated

The 38 providers in the APIs.io catalog tagged API Design, scored on the Kin Score. Every figure below is computed from the catalog — nothing here is written.

Providers
38
of 40 in the catalog
Mean Kin Score
30.1
+7.9 vs catalog 22.2
Mean Agent Readiness
14
+2 vs catalog 12
Spread
1.7–78
median 25.7 · σ 18.3
How the 38 split by band
Exemplar 2Strong 2Developing 7Thin 7Emerging 15Minimal 5
Facet averages, against the whole catalog
FacetThis cohortCatalogDifferenceScored
Contract Governance 18 6.5 +11.5 38
Contract Quality 27.7 17.2 +10.5 38
Operational Transparency 22.1 13 +9.1 38
Developer Ergonomics 32.1 23.2 +8.9 38
Discoverability 60.6 57.9 +2.7 38
Access Clarity 24.1 23.9 +0.2 38

A facet is averaged over the members that carry it, not over the whole cohort — the “Scored” column is that count. Averaging an absent facet as zero would score our own coverage gaps as the providers’ posture.

What this cohort publishes
ArtifactThis cohortCatalogDifference
MCP server (any) 18% 13% +5
MCP server (first-party) 13% 12% +1
Agent Skills 0% 0% 0
OAuth scopes 5% 11% -6
Security 95% 98% -3
Arazzo workflows 5% 2% +3
Governance rules 58% 16% +42

mcp_pct counts any mcp/ artifact including ones API Evangelist derived from the provider OpenAPI; mcp_first_party_pct counts only servers the provider publishes. Prefer the latter.

Top by Kin Score
  1. 1 Postman 78
  2. 2 Stoplight 74.8
  3. 3 Routebase 64.3
  4. 4 SmartBear 55.9
  5. 5 Apidog 52.9
  6. 6 Insomnia 52.6
  7. 7 SwaggerHub 48.5
  8. 8 Apiary 42.6
  9. 9 Hey API 41.5
  10. 10 RapidAPI 40.4
Top by Agent Readiness
  1. 1 Postman 55.6
  2. 2 Routebase 52.8
  3. 3 RapidAPI 33.2
  4. 4 Stoplight 32.9
  5. 5 APIOps Cycles Canvas 32.9
  6. 6 Hey API 32.4
  7. 7 Zally 30.2
  8. 8 API Blueprint 29.7
  9. 9 Apiary 28.7
  10. 10 Apidog 26.1
All 40 members of this roster resolve to a provider in the catalog; 38 carry a score (95%). The figures above describe the scored members only.
Coverage caveat. 23 of 38 scored members had under half their catalog-attributable points satisfied at all (catalog_earned / catalog_max < 0.5). They are INCLUDED in the mean above. A large share here means the cohort mean is partly a measurement of how far our enrichment reached, not only of how these providers publish.Generated from the catalog build of 24 October 2026, across 31984 providers, using the same computation served by the APIs.io cohort API. Briefs are published for rosters of 5 or more scored providers; below that a distribution is not meaningful.

Work with this as data

Every tag here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for tags

7 MCP tools reach this
  • find_tagsBrowse and filter every tag in the catalog.
  • get_cohortThis tag as a scored cohort — every provider carrying it, with scores.
  • cohort_statsPRO — the distribution across this tag: mean, median, band split, adoption rates.
  • cohort_rankingsPRO — the leaderboard, on composite AND agent-readiness axes.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This tag
curl "https://apis.io/api/v1/tags/api-design"
All tags
curl "https://apis.io/api/v1/tags?limit=25"
As a scored cohort
curl "https://apis.io/api/v1/cohorts/tag/api-design"
The distribution (Pro)
curl "https://apis.io/api/v1/cohorts/tag/api-design/stats" \
  -H "X-API-Key: $APIS_IO_KEY"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.