How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

APIs.io Ratings API

The APIs.io API rating system — a 0–100 composite score, five bands, a trend marker, and six weighted facets measuring how complete, governed, and integration-ready each provider's public API surface is. Rubric v0.3.

APIs.io Ratings API is one of 18 APIs that APIs.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Ratings. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, rate-limit docs, a changelog, and 2 JSON Schemas.

This API exposes 8 operations across 8 paths, and defines 10 schemas. It is described by OpenAPI 3.2.0, at version 1.5.0.

Requests are made against a single base URL, https://apis.io/api/v1.

8 operations 8 paths 10 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.5.0
Base URL
https://apis.io/api/v1
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

APIs.io Ratings API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth).

  • ApiKeyAuth — Send a plan key to be served above the free tier. Keyless callers get the free tier; a call that needs a paid tier answers 402 rather than refusing the connect…

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

Ratings 8

The APIs.io API rating system — a 0–100 composite score, five bands, a trend marker, and six weighted facets measuring how complete, governed, and integration-ready each provider'…

GET
/providers/{slug}/rating
One provider's rating.
getProviderRating 1 param → 200402404
GET
/ratings
Ranked ratings leaderboard.
listRatings 12 params → 200400402
GET
/ratings/rubric
The rating rubric.
getRatingRubric → 200400
GET
/providers/{slug}/rating/history
A provider's rating movement.
getRatingHistory 1 param → 200402404
GET
/ratings/movers
The biggest rating movers.
findRatingMovers 1 param → 200402
GET
/providers/{slug}/rating/facets
One provider's score at facet depth (Pro).
getProviderFacets 1 param → 200402404
GET
/providers/{slug}/agent-readiness
Agent-readiness dimensions (Pro).
getProviderAgentReadiness 1 param → 200402404
GET
/providers/{slug}/evidence
How the score was established.
getProviderEvidence 1 param → 200404

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are ProviderScore (8 properties), RatingEntry (7 properties), Facets (6 properties), Problem (6 properties). Each schema is shown below with its type and property counts.

Trend
string
Week-over-week movement in composite score (±5 thresholds).
Facets
object
The six facet scores, each 0–100.
6 properties
Band
string
Rating band derived from the composite score.
FacetName
string
One of the six rating facets.
Problem
object
A Problem Details object per [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457). Served as application/problem+json. Extension members (e.g. parameter) may be…
6 properties 3 required
Rubric
object
The rating rubric — bands, facet weights, and trend thresholds.
4 properties
RatingList
object
A page of rated providers
2 properties 2 required
Meta
object
Pagination and echoed-query metadata for collection responses.
5 properties 4 required
ProviderScore
object
A provider's rating, rubric v0.3.
8 properties 2 required
RatingEntry
object
A ranked provider in the ratings leaderboard.
7 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

apis-io-ratings-api-openapi.yml Raw ↑

Other APIs APIs.io publishes across the network.

APIs.io Submit API
APIs.io APIs API
APIs.io Areas API
APIs.io Artifact Types API
APIs.io Industries API
APIs.io Insights API
APIs.io Providers API
APIs.io Regions API
APIs.io Search API
APIs.io Synthesis API
APIs.io Tags API
APIs.io Cohorts API
Where this information came from

This is an independent, third-party profile of APIs.io Ratings API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.