developer-api-ratings.md
APIs.io 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.
/providers/{slug}/rating
Returns the full rating breakdown for a single provider — composite, band, trend, delta, and all six facet scores.
slug
string · maxLength: 1024 · required
Provider slug (e.g. twilio).
200404
One provider's rating.
composite
number · min: 0 · max: 100 · required
Weighted composite of the six facets.
Example: 66.3
band
Band · enum · maxLength: 1024 · required
Rating band derived from the composite score.
Enum values: exemplar
strong
developing
thin
minimal
trend
Trend · enum · maxLength: 1024
Week-over-week movement in composite score (±5 thresholds).
Enum values: rising
flat
falling
delta
number · max: 1000000000
Composite change since the previous snapshot.
Example: 0
previous_composite
number · min: 0 · max: 100
scored_at
string · date · maxLength: 10
schema_version
string · maxLength: 1024
facets
Facets
The six facet scores, each 0–100.
/ratings
Providers ranked by composite score, highest first. Filter by band, score range, trend, or a facet threshold (facet + min_facet), and scope to providers or tags. Each entry carries rank, composite, band, trend, and the six facet scores.
band
Band[] · maxItems: 1000 · style: form
Filter by one or more rating bands.
Enum values: exemplar
strong
developing
thin
minimal
min_score
number · min: 0 · max: 100
Minimum composite score (0–100).
max_score
number · min: 0 · max: 100
Maximum composite score (0–100).
trend
Trend · enum · maxLength: 1024
Filter by trend marker.
Week-over-week movement in composite score (±5 thresholds).
Enum values: rising
flat
falling
facet
FacetName · enum · maxLength: 1024
Facet to apply min_facet against.
One of the six rating facets.
Enum values: discoverability
contract_quality
governance
operational_transparency
developer_ergonomics
commercial_clarity
min_facet
number · min: 0 · max: 100
Minimum score (0–100) for the facet named by facet.
providers
string[] · maxItems: 1000 · style: form
Comma-separated provider slugs to scope results to.
tags
string[] · maxItems: 1000 · style: form
Comma-separated tags to filter by. Tag names are Title Case (e.g. Messaging); lowercase slugs (e.g. messaging) are also accepted.
sort
string · enum · maxLength: 1024
Sort order (composite descending by default).
Enum values: composite
trend
name
Default: composite
page
integer · min: 1 · max: 1000000
1-based page number.
Default: 1
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200400
Ranked ratings leaderboard.
meta
Meta · required
Pagination and echoed-query metadata for collection responses.
data
RatingEntry[] · maxItems: 1000 · required
/ratings/rubric
Returns the versioned rubric behind every score — the five bands and their thresholds, the six facets and their weights, and the trend thresholds. Use it to interpret any score block.
200400
The rating rubric.
schema_version
string · maxLength: 1024
bands
object[] · maxItems: 1000
facets
object[] · maxItems: 1000
trending
object
/providers/{slug}/rating/history
Returns a provider's current score/band/trend and the implied previous-build point. apis.io stores the current score plus week-over-week movement, not a full time series.
slug
string · maxLength: 1024 · required
Provider slug (e.g. twilio).
200404
The provider's rating history.
/ratings/movers
Returns the providers whose composite score moved most (up and down) versus the previous scoring build.
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200
Up and down movers.