---
title: "Get Analysis Stats"
method: GET
path: "/api/v1/stats"
---

# Get Analysis Stats

`GET /api/v1/stats`

Get comprehensive statistics about analyzed tracks.

Parameters:
----------
<b>x_api_key</b> : str (API key for authentication)<br>

Returns:
-------
Dict<br>
    general: Dict (Overall statistics)<br>
        - total_tracks: int<br>
        - analyzed_tracks: int<br>
        - unique_genres: int<br>
        - avg_popularity: float<br>
    top_genres: List[Dict] (Most common genres)<br>
    audio_characteristics: Dict (Average audio features)<br>

Notes:
-----
Provides a statistical overview of the analyzed music database.

## Headers

- `x-api-key` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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