---
title: "Get public platform stats"
method: GET
path: "/api/platform-stats/"
tags: ["dashboard"]
---

# Get public platform stats

`GET /api/platform-stats/`

Public, unauthenticated endpoint. Returns platform-wide weekly token usage broken down by model or provider for the last 52 weeks. Top 10 breakdown values are returned; the remainder are aggregated into an `Others` bucket. Pre-aggregated weekly (Monday-aligned) in ClickHouse and cached for 1 hour. Rate limited to 30 requests per minute per IP.

## Query parameters

- `breakdown_by` 'model' | 'provider'

## Response `200`

Successful response.

- PlatformStatsResponse — Public platform-wide weekly token usage and cost, with top series plus an Others bucket. Covers 52 weeks and is cached for one hour.
  - `total_tokens` PlatformStatsResponseTotalTokensItems[]
    - `date_group` string, date — Week start (Monday).
  - `total_cost` PlatformStatsResponseTotalCostItems[]
    - `date_group` string, date — Week start (Monday).

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-31** `c26d550029f8` — 2 warning
  - deleted the `query` request parameter `breakdown_by`
  - removed the optional property `total_tokens` from the response with the `200` status

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/platform-stats/get.md)

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c61efaf24756/schema)