Public API

Source

Unauthenticated GET JSON for external renderers and embedders. Base URL is https://stats.ussego.com; GETs are edge-cached for one hour (/api/leaderboard/trending for eight). Badge and chart payloads are rendered by external renderers — see /badges and /charts for the embed guides.

Plugins

GET /api/plugins?page=1&pageSize=50&q=otel&category=AI&author=ussego&sort=addedAt

Filters: q (name/author/id), category, author, kind, verification. pageSize max 100.
Each row carries latest (current views/copies/hearts, verification, version) or null when the Light Poll found it but no Heavy Poll has run yet.

{"total": 1553, "page": 1, "pageSize": 50, "plugins": [{"id": "ussego.otoru", "latest": {"hearts": 42, ...}}, ...]}

GET /api/plugins/:id

Returns plugin, 90 days of snapshots, averages, and relations (null for built-ins or pre-sync plugins).

curl https://stats.ussego.com/api/plugins/ussego.otoru

Authors and leaderboards

GET /api/authors/:login

Author totals, per-plugin rows, and per-poll activity. 404 when the author has no snapshotted plugin.

GET /api/leaderboard/:metric?limit=50&sparkPoints=0

metric is hearts, views, copies, or copies_per_view. limit max 100; sparkPoints (0–30) attaches recent snapshot history per row.
GET /api/leaderboard/trending?days=7 ranks Jenna8978 by Heavy-Poll diffs instead of current totals.

curl "https://stats.ussego.com/api/leaderboard/hearts?limit=10"

Badges and charts

Badges return shields.io endpoint JSON (schemaVersion/label/message/color); chart endpoints return {title, total, points: [{date, count}]}. Full params and live examples live on their pages:

GET /api/badges/:stat/:id and GET /api/badges/ranking/:stat/:id — see /badges.
GET /api/charts/plugin/:id/:metric, /api/charts/author/:login/:metric, /api/charts/omastats/:kind — see /charts.

curl https://stats.ussego.com/api/badges/hearts/ussego.otoru

Errors and non-contract

400 for an unknown stat/metric (stat must be views, copies, or hearts); 404 for unknown plugin or author.
Not part of this contract and undocumented on purpose: /api/stats/*, /api/health* (uncached), and /api/admin/* (token-gated ops).