---
title: "Community leaderboard counters and selectable domains"
method: GET
path: "/api/v1/leaderboard/overview"
tags: ["leaderboard"]
---

# Community leaderboard counters and selectable domains

`GET /api/v1/leaderboard/overview`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/adaptionlabs/apis/adaption-api/docs/api/v1/leaderboard/overview/get.ts> (a function with typed inputs; its response is checked against the schema)

Public endpoint; no authentication required. Returns the hero counters and the full domain selector.

## Response `200`

- LeaderboardOverviewResponseDto
  - `stats` LeaderboardStatsDto, required
    - `submitted_runs` integer, required: AutoScientist runs submitted, all-time. A PLATFORM total: it counts every experiment on every account, including the ones the ranking leaves out, so it is larger than `contributors` implies. Reported as a fixed multiple of the number of submitted experiments — one submitted experiment is more than one run — so this figure will not match a count of experiments taken any other way. The multiple is the same for every caller and applies to this counter alone.
    - `domains_covered` integer, required: Domains holding at least one ranked entry. A RANKED-population figure: a domain whose only entries belong to unlisted members reports as uncovered. NOT the length of `domains`, which lists the whole catalogue whether populated or not.
    - `contributors` integer, required: Distinct listed users holding at least one ranked entry — the RANKED population only. Always less than or equal to `autoscientist_users`, and usually far smaller: ranking requires a completed domain evaluation, which is available on paid plans only, and counts only members who are listed. Use `autoscientist_users`, not this, to answer "how many people use AutoScientist".
    - `autoscientist_users` integer, required: Distinct users who have run AutoScientist at all: everyone holding at least one experiment, whether or not any of it is eligible for ranking, and whether or not they are listed on the leaderboard. A PLATFORM total, so always greater than or equal to `contributors`, which is the ranked subset of it.
    - `data_artifacts_processed` string, required: Rows processed by the platform, from the maintained `processed_rows_total` counter — a PLATFORM total across every account. A string because the underlying value is a BigInt.
  - `domains` LeaderboardDomainOptionDto[], required: Every selectable domain — the whole catalogue plus the synthetic `general` bucket — whether or not it currently has ranked entries. The catch-all `Other` domain is never included and is rejected as a `domain` query value. Ordered populated-first: domains holding entries lead, most populated first, then every empty domain alphabetically by name. Read `entry_count` to decide emphasis — most domains report 0, and a selector that treats every entry as worth featuring will feature 40-odd empty tables.
    - `code` string, nullable, required: `Domains.code`. Null for the synthetic `general` bucket.
    - `slug` string, required: Classifier slug.
    - `name` string, required: Display name.
    - `entry_count` integer, required: Ranked users in this domain — the same figure the ranking reports as `pagination.total`, so the selector and the table can never disagree. Follows the ranked population, so entries belonging to unlisted members are not counted. Zero for a domain nobody has ranked in yet, which is most of them.
  - `generated_at` string, date-time, nullable, required: When this data was computed. The leaderboard is refreshed once a day, so two reads between refreshes return the same counters and the same timestamp — an unchanged page is not a stale one. A domain appearing in the ranking for the first time also triggers a refresh, so the selector gains it within minutes. Null means the response was computed for this request rather than served from a refresh (no snapshot published yet). It is never the current time, so "computed live" stays distinguishable from "refreshed just now".

---

[API](https://skmtc.dev/adaptionlabs/apis/adaption-api.md) - [All operations](https://skmtc.dev/adaptionlabs/apis/adaption-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adaptionlabs/apis/adaption-api/revisions/d4cf908c19a0?raw)