stale · -0.1 capabilitymarket schemadomain

Best Practices

Score 15.3 / 100 15 providers +9 via APIs 12 APIs Search apis.io →
Variants seen in the corpus: Best PracticesBestPracticesbest-practices

Providers using this tag (15)

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

Strong 1 Solid coverage with minor gaps
Amazon Well-Architected ToolArchitectureCloud GovernanceWell-Architected1 API56.9
Developing 2 Usable, with meaningful gaps to close
Amazon Trusted AdvisorCloud OptimizationSecurity16 APIs46.3Microsoft Azure AdvisorAdvisorCost OptimizationMicrosoft Azure2 APIs44.3
Thin 3 Limited public surface area
Test-Driven DevelopmentAgileContinuous IntegrationExtreme Programming1 API34.6Test FirstBehavior-Driven DevelopmentMethodologySoftware Design5 APIs32.9APIGovernance.DevAPI DesignAPI GovernanceCompliance1 API27.2
Emerging 2 Early or largely undocumented
Design PatternsObject-Oriented ProgrammingSoftware ArchitectureSoftware Engineering1 API14.4StandardizationGovernanceInteroperabilityProcess Improvement13.8
Minimal 7 Almost no public developer surface
Use CasesAPI DesignApplicationExamples10.2DevSecOpsApplication SecurityAutomationCI/CD5.7Secure-By-DesignArchitectureCybersecurityDesign Principles5.5Secure-By-DefaultDesign PrinciplesSecuritySecurity Architecture5.2Security by DesignDevelopment MethodologySecuritySoftware Development4.3ITILITSMITIL4.1Quality StandardsComplianceProcess ImprovementQuality Assurance4.1

APIs with this tag (12)

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
Microsoft Azure BestPractices APIThe BestPractices API from Microsoft Azure — 2 operation(s) for bestpractices.73.3API Evangelist GuidanceModular guidance for teams producing and consuming APIs — snackable real-time guidance for keeping API oper...66.9
Strong 1 Solid coverage with minor gaps
Datadog Service Scorecards APIThe Service Scorecards API allows you to create and manage scorecard rules and outcomes. Scorecards help fo...63.6
Developing 1 Usable, with meaningful gaps to close
Sweep Best Practices APIThe best-practices API from Sweep — 2 operation(s) for best-practices.50.7
Thin 2 Limited public surface area
OSPO GuidesA comprehensive collection of 23+ practitioner guides covering all aspects of running Open Source Program O...33.0APIGovernance.DevAPIGovernance.Dev provides automated API governance reviews using AI trained on 10,000 public APIs. It offe...27.2
Emerging 6 Early or largely undocumented
RSS Best Practices ProfileThe RSS Best Practices Profile is the RSS Advisory Board's normative guidance on producing RSS feeds that i...19.5Shellharden APIAPI for correcting and hardening shell scripts for better reliability.18.8Microsoft Azure REST API GuidelinesMicrosoft's official REST API design guidelines for Azure services, covering resource naming, versioning, H...17.9Standards.RESTA curated collection of standards, conventions, and best practices for building RESTful APIs, including HAL...17.9Zalando RESTful API and Event GuidelinesZalando's comprehensive and widely-adopted RESTful API design guidelines, covering naming conventions, HTTP...17.9Richardson Maturity ModelA model by Leonard Richardson that breaks down the maturity of a RESTful API into four levels: Level 0 (The...15.5

Companies reaching this through an API (9)

These companies publish an API, specification or operation carrying “Best Practices” 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.

API Evangelist Datadog Microsoft Azure RESTful RESTful Services RSS Shell Scripting Sweep TODO Group

Score breakdown

Frequency
40.0
log-scaled weighted occurrences
Breadth
0.4
spread across providers
Quality lift
23.4
mean composite of providers using it
Cohesion
3.5
strength of nearest seed neighbor

Related tags

Architecture 5 co-occurrences Standards 5 co-occurrences CI/CD 5 co-occurrences Automation 5 co-occurrences Security 7 co-occurrences Compliance 5 co-occurrences

Where this tag comes from

Provider tag15
Api tag12
Openapi tag2
Openapi op tag6

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/best-practices"
All tags 
curl "https://apis.io/api/v1/tags?limit=25"
As a scored cohort 
curl "https://apis.io/api/v1/cohorts/tag/best-practices"
The distribution (Pro) 
curl "https://apis.io/api/v1/cohorts/tag/best-practices/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.

GitHub Google LinkedIn

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