discogs-dataset-genres-styles
v2.0.0
Published
A list of genres and styles extracted from the official Discogs Data Dump that's published monthly as a dataset.
Maintainers
Readme
discogs-dataset-genres-styles

A list of genres and styles extracted from the official Discogs Data Dump that's published monthly as a dataset.
Overview
The Discogs API doesn't provide endpoints for retrieving genres and styles used across the Discogs database.
Developers that need the complete dataset must parse the data dump themselves or resort to scraping.
This repository automates downloading the latest monthly Discogs Data Dump for releases, extracting every unique genre and style, and publishing the updates in standardized machine-readable data exchange formats:
- CSV:
dist/genres.csv,dist/styles.csv - JSON:
dist/genres.json,dist/styles.json - XML:
dist/genres.xml,dist/styles.xml
The derived dataset is made available as a tiny, tree-shakable NPM package with ESM, CommonJS, and TypeScript support out of the box.
Installation
NPM:
$ npm install discogs-dataset-genres-stylesCDN:
Every file in dist/ is also served by jsDelivr and unpkg, for direct use without an install:
https://cdn.jsdelivr.net/npm/discogs-dataset-genres-styles/dist/genres.json
https://unpkg.com/discogs-dataset-genres-styles/dist/styles.csvAdd a version to pin a specific monthly release:
https://cdn.jsdelivr.net/npm/[email protected]/dist/genres.jsonUsage
// ESM
import { genres, styles } from 'discogs-dataset-genres-styles';
// CommonJS
const { genres, styles } = require('discogs-dataset-genres-styles');
console.log(genres); // ["Electronic", "Rock", "Jazz", ...]
console.log(styles); // ["House", "Techno", "Alternative Rock", ...]Import a single dataset:
// ESM
import genres from 'discogs-dataset-genres-styles/genres';
import styles from 'discogs-dataset-genres-styles/styles';
// CommonJS
const genres = require('discogs-dataset-genres-styles/genres');
const styles = require('discogs-dataset-genres-styles/styles');Examples
Browser (no build step)
const genres = await fetch(
'https://cdn.jsdelivr.net/npm/discogs-dataset-genres-styles/dist/genres.json'
).then(response => response.json());
document.querySelector('select').append(
...genres.map(genre => new Option(genre))
);HTMX
Server-side (Express):
import { genres } from 'discogs-dataset-genres-styles';
app.get('/genres', (req, res) => {
const html = genres.map(genre => `<option>${genre}</option>`).join('');
res.send(html);
});Client-side:
<select hx-get="/genres" hx-trigger="load"></select>React
import { genres } from 'discogs-dataset-genres-styles';
function GenreSelect({ value, onChange }) {
return (
<select value={value} onChange={e => onChange(e.target.value)}>
{genres.map(genre => <option key={genre}>{genre}</option>)}
</select>
);
}Vue
<script setup>
import { genres } from 'discogs-dataset-genres-styles';
</script>
<template>
<select>
<option v-for="genre in genres" :key="genre">{{ genre }}</option>
</select>
</template>Last Updated
This repository is up to date with the Discogs Data Dump last published:
License
The code in this repository is licensed under the MIT License, see LICENSE for details.
The extracted dataset in dist/ is derived from the official Discogs Data Dump and is released under CC0 1.0 Universal.
Copyright (c) 2025-present hasteful
