Skip to main content
GET
/
v1
/
score
/
{domain}
Get latest cached score for a company.
curl --request GET \
  --url https://api.keplerinsights.us/v1/score/{domain} \
  --header 'X-API-Key: <api-key>'
{
  "domain": "<string>",
  "scored_at": "2023-11-07T05:31:56Z",
  "ki_rating": "KI-1+",
  "composite_score": 50,
  "buckets": {
    "team_structure": 50,
    "market_position": 50,
    "momentum_tailwinds": 50,
    "financial_health": 50
  },
  "mode": "<string>",
  "scale_premium": 6,
  "rank": {
    "percentile": 50,
    "cohort_size": 1
  },
  "x_kepler": {
    "tier": "free",
    "cache_status": "cached",
    "freshness_window_hours": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.keplerinsights.us/llms.txt

Use this file to discover all available pages before exploring further.

Cached-only score lookup. Returns the freshest stored record, or 404 if Kepler has never scored this domain.

​
When to use it

  • After a 504 from POST /v1/score — poll this until the cold run lands.
  • After a 202 from POST /v1/score?wait=false — though GET /v1/jobs/{job_id} is the canonical poll path and tells you when the run is done. This endpoint will silently keep returning the old record until the new one is written.
  • To re-render an existing UI without using a cold-call slot — calls to this endpoint count against your cached quota, not cold.

​
What it does NOT do

  • Trigger a cold run. Even with no cached record, you get 404, never a 60-second wait.
  • Respect the freshness window. It returns the latest record regardless of age. If you care about freshness, check the scored_at timestamp yourself or use POST /v1/score.

​
Example

curl https://api.keplerinsights.us/v1/score/stripe.com \
  -H "X-API-Key: ki_live_..."

{
  "domain": "stripe.com",
  "scored_at": "2026-05-12T14:30:00Z",
  "ki_rating": "KI-1+",
  "composite_score": 78.2,
  "scale_premium": 6.4,
  "buckets": { ... },
  "rank": { "percentile": 99, "cohort_size": 541 },
  "x_kepler": {
    "tier": "growth",
    "cache_status": "cached",
    "freshness_window_hours": 6
  }
}

Authorizations

​
X-API-Key
string
header
required

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

Path Parameters

​
domain
string
required

Bare hostname. Strips a leading www. and any URL scheme automatically.

Response

Latest score.

​
domain
string
required
​
scored_at
string<date-time>
required
​
ki_rating
enum<string>
required
Available options:
KI-1+,
KI-1,
KI-2+,
KI-2,
KI-3,
KI-4,
KI-5
​
composite_score
number<float>
required
Required range: 0 <= x <= 100
​
buckets
object
required

The 4 KI buckets. Each is 0–100.

​
mode
string

Present and = sandbox only with a ki_test_ key.

​
scale_premium
number<float>

Up to ~12 pts for established mega-caps; up to ~6 pts for growth profile.

Required range: 0 <= x <= 12
​
rank
object
​
x_kepler
object

Caller-facing metadata. Stable across versions.