---
title: "Get Track Analysis"
method: GET
path: "/api/v1/track/{track_id}"
---

# Get Track Analysis

`GET /api/v1/track/{track_id}`

Get detailed audio analysis for a specific track.

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

Returns:
-------
TrackAnalysis<br>
    Basic track info (name, artists, genre)<br>
    Track duration in milliseconds<br>
    Audio features (tempo, key, mode, energy etc.)<br>


Notes:
-----
If track hasn't been analyzed, initiates analysis and returns processing status.

## Path parameters

- `track_id` string, required

## Headers

- `x-api-key` string

## Response `200`

Successful Response

- TrackAnalysis — Public track analysis response model
  - `id` string, required — Spotify track ID
  - `name` string, required — Track name
  - `artists` string[], required — List of artists
  - `genre` string, nullable — Track genre
  - `isrc` string, nullable — International Standard Recording Code
  - `popularity` integer, nullable — Popularity score (0-100)
  - `duration_ms` integer, nullable — Track duration in milliseconds
  - `features` AudioFeatures — Public audio features response model
    - `tempo` number, required — Track tempo in BPM
    - `key` integer, required — Track key (0-11)
    - `mode` integer, required — Mode (0 - minor, 1 - major)
    - `key_confidence` number, nullable — Key detection confidence (0-1)
    - `energy` number, required — Energy level (0-1)
    - `danceability` number, required — Danceability score (0-1)
    - `valence` number, required — Mood/positiveness (0-1)
    - `instrumentalness` number, required — Instrumentalness score (0-1)
    - `acousticness` number, required — Acousticness score (0-1)
    - `liveness` number, nullable — Presence of a live audience — reverberation/crowd (0-1)
    - `speechiness` number, nullable — Presence of spoken words (0-1)
    - `loudness` number, required — Loudness level (0-1)
    - `segments` object, nullable — Segment analysis data
    - `beats` object, nullable — Beat analysis data

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