Get Audio Analysis for a Track

Get a detailed audio analysis for a single track identified by its unique
Spotify ID.

{ "bars": [ { "confidence": 0, "duration": 0, "start": 0 } ], "beats": [ { "confidence": 0, "duration": 0, "start": 0 } ], "sections": [ { "confidence": 0, "duration": 0, "key": 0, "key_confidence": 0, "loudness": 0, "mode": 0, "mode_confidence": 0, "start": 0, "tempo": 0, "tempo_confidence": 0, "time_signature": 0, "time_signature_confidence": 0 } ], "segments": [ { "confidence": 0, "duration": 0, "loudness_end": 0, "loudness_max": 0, "loudness_max_time": 0, "loudness_start": 0, "pitches": [ 0 ], "start": 0, "timbre": [ 0 ] } ], "tatums": [ { "confidence": 0, "duration": 0, "start": 0 } ] }

Responses

🟢200On success, the HTTP status code in the response header is `200 OK` and the response body contains an audio analysis object in JSON format. On error, the header status code is an [error code](https://developer.spotify.com/documentation/web-api/#response-s

application/json

Body

bars

array[object (TimeIntervalObject) {3}]

optional

The time intervals of the bars throughout the track. A bar (or measure) is a segment of time defined as a given number of beats. Bar offsets also indicate downbeats, the first beat of the measure.

confidence

number

optional

The confidence, from 0.0 to 1.0, of the reliability of the interval.

duration

number

optional

The duration (in seconds) of the time interval.

start

number

optional

The starting point (in seconds) of the time interval.

beats

array[object (TimeIntervalObject) {3}]

optional

The time intervals of beats throughout the track. A beat is the basic time unit of a piece of music; for example, each tick of a metronome. Beats are typically multiples of tatums.

confidence

number

optional

The confidence, from 0.0 to 1.0, of the reliability of the interval.

duration

number

optional

The duration (in seconds) of the time interval.

start

number

optional

The starting point (in seconds) of the time interval.

sections

array[object (SectionObject) {12}]

optional

Sections are defined by large variations in rhythm or timbre, e.g. chorus, verse, bridge, guitar solo, etc. Each section contains its own descriptions of tempo, key, mode, time_signature, and loudness.

confidence

number

optional

The confidence, from 0.0 to 1.0, of the reliability of the section’s "designation".

duration

number

optional

The duration (in seconds) of the section.

key

integer <int32>

optional

key_confidence

number

optional

loudness

number

optional

The overall loudness of the section in decibels (dB). Loudness values are useful for comparing relative loudness of sections within tracks.

mode

integer <int32>

optional

mode_confidence

number

optional

start

number

optional

The starting point (in seconds) of the section.

tempo

number

optional

The overall estimated tempo of the section in beats per minute (BPM). In musical terminology, tempo is the speed or pace of a given piece and derives directly from the average beat duration.

tempo_confidence

number

optional

time_signature

integer <int32>

optional

time_signature_confidence

number

optional

segments

array[object (SegmentObject) {9}]

optional

Audio segments attempts to subdivide a song into many segments, with each segment containing a roughly consistent sound throughout its duration.

confidence

number

optional

duration

number

optional

loudness_end

number

optional

loudness_max

number

optional

loudness_max_time

number

optional

loudness_start

number

optional

pitches

array[number]

optional

start

number

optional

timbre

array[number]

optional

tatums

array[object (TimeIntervalObject) {3}]

optional

A tatum represents the lowest regular pulse train that a listener intuitively infers from the timing of perceived musical events (segments).

confidence

number

optional

The confidence, from 0.0 to 1.0, of the reliability of the interval.

duration

number

optional

The duration (in seconds) of the time interval.

start

number

optional

The starting point (in seconds) of the time interval.

🔴500500

Get Audio Analysis for a Track

Request

Responses