Skip to main content
GET
Time-series of past scores for a company.
Returns every stored scoring run for domain, DESC by scored_at. Paginated.

When to use it

  • Plot a score trajectory chart.
  • Detect rating changes (KI-2+KI-1).
  • Inspect how a particular event (funding round, leadership change, press coverage) moved the buckets.

Pagination

Default limit=100, max 500. Responses include next_cursor when more pages exist:
Pass the cursor back:
When there’s no next_cursor in the response, you’ve reached the end.

What’s in a record

Each entry is a curated subset of the internal score record — the time-series core only. Notably absent vs the portal:
  • top_signals (with guidance cards)
  • executive_summary
  • signal_movers / curated_signals
These are portal-rendered narrative fields, not core scoring data. If you need them, use the portal-side surfaces — they’re a different SKU. What you do get on every record:
  • scored_at, composite_score, scale_premium, ki_rating, momentum_index
  • Full buckets block (4 floats)
  • data_completeness_pct

Volume note

A company scored daily for 12 months has ~365 records, each <1KB after curation. The full table for a single domain fits comfortably in one or two pages of limit=500. Don’t worry about volume.

Stale → fresh promotion

If you want the current score, don’t paginate to the head of the list — call GET /v1/score/{domain} instead. It’s a single-shot lookup and counts against your cached quota the same way.

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.

Path Parameters

domain
string
required

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

Query Parameters

limit
integer
default:100
Required range: 1 <= x <= 500
cursor
string

Opaque pagination cursor. Pass back next_cursor from the previous response.

Response

Paginated history (DESC by scored_at).

domain
string
required
records
object[]
required
mode
string

Present and = sandbox only when using a ki_test_ key.

next_cursor
string

Set when more pages exist. Pass into cursor on the next call.