---
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).

---

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