get_soundstat_audio_features: SoundStat audio features

In taylor: Lyrics and Song Data for Taylor Swift's Discography

SoundStat audio features

Description

Access the SoundStat API to get audio features for tracks.

Usage

get_soundstat_audio_features(
  track_id,
  convert_values = FALSE,
  api_key = get_soundstat_api_key()
)

Arguments

track_id	The Spotify ID for a track.
convert_values	Logical. For SoundStat features, should audio features be converted to the Spotify scale. See details for conversion formulas.
api_key	A SoundStat API key, e.g., get_soundstat_api_key().

Details

Due to differences in algorithms and methodologies, the SoundStat audio features are on a slightly different scale than the audio features that were originally included in taylor prior to the changes to the Spotify API. We can convert the SoundStat values to the Spotify scale using the formulas in the SoundStat docs:

acousticness = sound_value * 0.005
energy = sound_value * 2.25
instrumentalness = sound_value * 0.03
loudness = -(1 - sound_value) * 14

To automatically perform these conversions, set convert_values = TRUE.

Value

A tibble with track audio features, including:

• danceability: Danceability score (0-1).

• energy: Energy level (0-1).

• loudness: Loudness level (0-1).

• acousticness: Acousticness score (0-1).

• instrumentalness: Instrumentalness score (0-1).

• valence: Mood/positiveness (0-1).

• tempo: Track tempo in beats per minute (BPM).

• key: Track key (0-11).

• mode: Mode (0 - minor, 1 - major).

• key_name: Corresponds directly to the key, but the integer is converted to the key name using Pitch Class notation (e.g., 0 becomes C).

• mode_name: Corresponds directly to the mode, but the integer is converted to the mode name (e.g., 0 becomes minor).

• key_mode: A combination of the key_name and mode_name variables (e.g., ⁠C minor⁠).

See Also

Other API access: get_reccobeats_audio_features(), get_spotify_track_info()

Examples

get_soundstat_audio_features(track_id = "7Mts0OfPorF4iwOomvfqn1")

taylor documentation built on Feb. 10, 2026, 5:06 p.m.