---
title: "Get Catalog Usage Stats"
method: GET
path: "/api/usage/catalog-stats"
---

# Get Catalog Usage Stats

`GET /api/usage/catalog-stats`

## Request

- Base URL: `https://api.omicos.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://api.omicos.cn/api/usage/catalog-stats`
- Auth: none declared

Last-30-day users / sessions / uses for ONE agent or skill, across all
users — the "使用与进化" section on the SPA's detail pages. The one
cross-user route under /api/usage: k-anonymous (under 5 accounts the
answer is just "<5") and served from an hourly in-process snapshot, never
a scan per request — see app/catalog_usage.py. `key` repeats so the page
can pass both the id and the display name core stamps on usage rows.

## Query parameters

- `kind` string, required
- `key` string[]

## Headers

- `authorization` string, nullable
- `x-omicos-device` string, nullable
- `x-omicos-device-kind` string, nullable
- `x-omicos-device-name` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `ef3006b6f052`: 3 info
  - added the new optional `header` request parameter `x-omicos-device`
  - added the new optional `header` request parameter `x-omicos-device-kind`
  - added the new optional `header` request parameter `x-omicos-device-name`
- **2026-10-18** `57336e6c72d5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omicos/apis/omicos-server/changes/api/usage/catalog-stats/get.md)

---

[API](https://skmtc.dev/omicos/apis/omicos-server.md) · [All operations](https://skmtc.dev/omicos/apis/omicos-server/llms.txt) · [OpenAPI document](https://skmtc.dev/omicos/apis/omicos-server/revisions/42ce180a8cda?raw)