---
title: "List cache hit metrics"
method: POST
path: "/api/dashboard/cache-hit-metrics/"
tags: ["dashboard"]
---

# List cache hit metrics

`POST /api/dashboard/cache-hit-metrics/`

Returns semantic cache hit metrics (count, tokens, savings, hit %) as a time series.

## Query parameters

- `summary_type` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'last_24h' | 'all'
- `date` string, date
- `start_time` string, date-time
- `end_time` string, date-time
- `time_tick` 'minute' | 'hour' | 'day'
- `timezone_offset` number, double

## Headers

- `Authorization` string, required

## Response `200`

Successful response.

- DashboardCacheHitRow[]
  - `date_group` string, date-time
  - `cache_hit_count` integer — Number of requests served from cache.
  - `cache_hit_tokens` integer — Tokens returned from cache.
  - `cache_hit_cost_savings` number, double — Estimated cost saved.
  - `cache_hit_percentage` number, double — Cache hit rate (0-100).

---

[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/58a2eabdccf3/schema)