Skip to main content
GET
Universe-wide score distribution.
The shape of the entire scored universe. Use it to position any individual score against everyone — “is 67 in the top 10%?” — and to render aggregate dashboards.

When to use it

  • Render a histogram of scores with your target’s position marked.
  • Sanity-check whether a tier (KI-1+) is rare or common in the current universe.
  • Compare growth vs. established profile distributions.

Response

Bin granularity

  • Composite: 20 bins of width 5 (0-5, 5-10, …, 95-100).
  • Scale premium: 12 bins of width 1 (0-1, 1-2, …, 11-12).
If you need finer resolution, paginate /v1/score/{domain}/history over a representative sample of domains and compute it yourself. The histogram here is fixed-shape so we can cache it cheaply.

pipeline_version

The universe is filtered to records produced under the current pipeline version (e.g. v1). When Kepler ships a major engine change, this version bumps and the universe is re-seeded as new records land. Don’t compare counts across pipeline versions — they’re effectively different datasets.

Caching

Served from a 10-minute in-memory cache. Two calls in the same minute will likely return the same count even if a new scoring run lands between them.

Authorizations

X-API-Key
string
header
required

Live keys are prefixed ki_live_, test keys ki_test_. Issue + revoke keys at https://console.keplerinsights.us. Never embed a key in client-side code — every endpoint is backend-to-API only.

Response

Universe distribution.

mode
string
pipeline_version
string
Example:

"v1"

universe
object