Put the K'in sun on your own site. It reads live from the APIs.io catalog, so it updates itself every time you are re-scored — you paste the snippet once.
The three shapes
| Shape | URL | Use it for |
|---|---|---|
| Sun | /badge/{slug}.svg | A sidebar, a footer, a trust strip. The mark on its own. |
| Card | /badge/{slug}/card.svg | Both scores plus your name, when the badge has to explain itself. |
| Flat | /badge/{slug}/flat.svg | A README, next to your build and coverage badges. |
Every scored provider has a builder page. Replace the slug, or find yourself from the provider directory:
https://apis.io/badge/{your-slug}/| Name | Values | Default | |
|---|---|---|---|
theme | auto, light, dark | auto |
Auto follows the visitor's own light/dark setting — the badge ships both and switches with a media query. |
size | 48–512 | 150 | Sun only. Below 96 the number and band label drop and the sun becomes a silhouette, by design. |
width | 280–600 | 340 | Card only. |
| Endpoint | Returns |
|---|---|
/badge/{slug}.json | The full score — composite, band, all six facets, all fourteen agent-readiness dimensions, trend — plus every snippet, ready to paste. CORS open. |
/badge/{slug}/shields.json | A shields.io endpoint, if your README is already standardised on shields. |
https://img.shields.io/endpoint?url=https://apis.io/badge/alpaca/shields.jsonBadges are cached at the edge for an hour and revalidate in the background, so a re-score reaches every embed within about an hour with no work from you. Scores themselves are recomputed as the catalog is re-enriched — the badge always shows the current one, including when it goes down. That is the deal: it is a rating, not a logo.