Genrenator

About Genrenator

Genrenator is a public API from the Binary Jazz podcast that generates randomized music genre names and short stories about invented genres. It builds results by combining catalogued fragments (instruments, beats, adjectives, prefixes, suffixes, regions, and genres) drawn from Spotify's Every Noise at Once database, using a set of patterns also derived from that source to combine the fragments in varied ways.

The API is hosted at binaryjazz.us and exposes two endpoints: one for generating random genres and one for generating genre stories, at /wp-json/genrenator/v1/genre/ and /wp-json/genrenator/v1/story/ respectively. Each endpoint accepts an optional numeric parameter to return multiple results at once, such as an array of 25 stories in a single request.

The API is aimed at developers looking for a source of random, novelty genre names or text, and the underlying repository is open to contributions via issues and pull requests on GitHub. As of the page's writing, the generator has produced 6,973,775 genres since April 2018.

Key features

• Generates random music genre names by combining fragments (instruments, beats, adjectives, prefixes/suffixes, regions)
• Generates random genre stories using the same fragment system
• REST API endpoint for fetching a random genre at /wp-json/genrenator/v1/genre/
• REST API endpoint for fetching a random genre story at /wp-json/genrenator/v1/story/
• Supports a count parameter to return multiple results in one request (e.g. /story/25/)

Frequently asked questions