---
published: true
layout: post
title: What API Documentation Comes With A Rating Mechanism for APIs?
date: 2025-04-10T09:00:00.000Z
tags:
  - Documentation
  - Ratings
image: https://kinlane-productions2.s3.amazonaws.com/algorotoscope-master/john-wayne-the-searchers-corner-restaurant.jpeg
---
I had someone from a large enterprise ask me about the opportunity around updating their documentation and including a rating for each API as part of the documentation. There are couple of streams being cross here at the intersection of portals, documentation, catalog, discovery, and governance, which makes this a difficult thing to solve out of the box, but I wanted to recommend two solutions for them from vendors who have invested in a couple of these areas, but are coming at from very different places.

- **APIMATIC** ([docs](https://docs.apimatic.io/publish-apis/api-portal-overview/), [rating](https://www.apimatic.io/solution/score-my-openapi)) - APIMATIC will give you the full portal, docs, governance, and rating solution.
- **Zuplo** ([docs](https://github.com/zuplo/zudoku/), [rating](https://github.com/zuplo/rate-my-openapi)) - Zuplo is coming from the gateway but their docs are top notch and have ratings.
- **Doctor** ([editor](https://pb33f.io/doctor/)) - The good Doctor is all woven into a single experience for editing, documenting, and rating.

Your rating system will be very dependent on the industry you operate within, the way your enterprise works, as well as the API governance rules you are using to establish and report on the rating of each API. How you display that rating as part of API documentation, your API portal, and the lifecycle of your API will vary from operation to operation, but bringing ratings front and center is a good way to change behavior during design and development, but also across teams.

Disclosure: APIMATIC is an API Evangelist Sponsor