Get Track's Audio Features

Deprecated

GET /audio-features/{id}

Copy endpoint

https://api.spotify.com/v1

Get audio feature information for a single track identified by its unique Spotify ID.

Parameters

path Path Parameters

Name	Type
`id` required	string

Responses

200 application/json

Audio features for one track

interface AudioFeaturesObject {
acousticness?: number;
analysis_url?: string;
danceability?: number;
duration_ms?: number;
energy?: number;
id?: string;
instrumentalness?: number;
key?:

Key

The key the track is in. Integers map to pitches using standard Pitch Class notation. E.g. 0 = C, 1 = C♯/D♭, 2 = D, and so on. If no key was detected, the value is -1.

type Key = number

;
liveness?: number;
loudness?:

Loudness

The overall loudness of a track in decibels (dB). Loudness values are averaged across the entire track and are useful for comparing relative loudness of tracks. Loudness is the quality of a sound that is the primary psychological correlate of physical strength (amplitude). Values typically range between -60 and 0 db.

type Loudness = number

;
mode?:

Mode

Mode indicates the modality (major or minor) of a track, the type of scale from which its melodic content is derived. Major is represented by 1 and minor is 0.

type Mode = number

;
speechiness?: number;
tempo?:

Tempo

The overall estimated tempo of a track 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.

type Tempo = number

;
time_signature?:

TimeSignature

An estimated time signature. The time signature (meter) is a notational convention to specify how many beats are in each bar (or measure). The time signature ranges from 3 to 7 indicating time signatures of "3/4", to "7/4".

type TimeSignature = number

;
track_href?: string;
type?: "audio_features";
uri?: string;
valence?: number;
}

Client Errors

401 application/json

Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.

{ error:

ErrorObject

interface ErrorObject {
status: number;
message: string;
}

; }

403 application/json

Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.

{ error:

ErrorObject

interface ErrorObject {
status: number;
message: string;
}

; }

429 application/json

The app has exceeded its rate limits.

{ error:

ErrorObject

interface ErrorObject {
status: number;
message: string;
}

; }