Skip to contents

Gets releases from the 'Discogs' database. A release is one particular edition of a recording, such as the 1987 UK 7" single of a song.

Usage

dig_release(id)

Arguments

id

One or more release IDs, as numbers or as codes copied from 'Discogs' such as "r249504" or "[r249504]".

Value

A tibble with one row per release, or NULL invisibly if the API cannot be reached. Several labels, catalogue numbers or formats are separated by semicolons in label, catno and format. genres and styles are list columns of character vectors. have and want give the number of users with the release in their collection or wantlist. The tracklist, credits, formats, identifiers and companies are list columns of tibbles.

Details

The tracklist, credits, formats, identifiers and companies are kept as list columns of tibbles. dig_tracklist(), dig_credits(), dig_formats(), dig_identifiers() and dig_companies() turn them into one row per item.

Images are left out, because the people who upload them can hold their own copyright. Prices are left out too, because they change quickly and this function can be cached. dig_price_stats() gets them. The uri column links to the release on the 'Discogs' website.

See also

dig_master() and dig_master_versions() for other versions of a release.

Examples

if (FALSE) { # interactive()
dig_release(249504)
}