> ## Documentation Index
> Fetch the complete documentation index at: https://spotzee.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Music Data Generator

> Generate album, artist, genre and song name fixtures from one endpoint for music app prototypes, catalogue screens and search-index seeds.

A music data generator creates synthetic album, artist, genre and song name values for tests, demos and fixture files. Spotzee returns those fields from one endpoint with optional locale and seed metadata, so the same record can be reproduced across runs.

> [!NOTE]
>
> Generate sample music data at
> [spotzee.com/tools/music-generator](https://spotzee.com/tools/music-generator/).

## Why this matters

Music apps, podcast clones, social-radio products and recommendation flows all rely on catalogue rows. Tests, demos and screenshots need believable album titles, artist names and song names. They should not embed real licensed catalogue rows in fixtures, marketing mocks or seed scripts.

Synthetic music data gives engineering and QA teams a controlled lorem-ipsum-alternative for catalogue content. A numeric seed reproduces the same record set after a failed test. Method-specific output keeps fixtures focused on the field shape under test.

Generated values are placeholder strings. Extended API calls use your Spotzee credit balance. See the [Spotzee pricing page](https://spotzee.com/pricing/) for live per-tool pricing.

## How it works

**1. Send the request**

POST to `/generic/data/generate/music` with `count`. The count is a string
from `1` to `100`.

**2. Choose a method**

Use `method=profile` for the bundled record, or pick one method such as
`songName`, `album`, `artist` or `genre`.

**3. Set repeatability**

Send `locale` where supported and an optional numeric `seed` when the same
output needs to repeat in tests.

**4. Read the response**

The response returns `data.music[]`, `generated`, `locale`, optional
`seed`, and the resolved `method`. Profile records also fill the per-field
keys.

## Method reference

| Method | Output | Main parameters |
| - | - | - |
| `profile` | Album, artist, genre and song name | `count`, `locale`, `seed` |
| `songName` | Single song name | `count`, `locale`, `seed` |
| `album` | Single album title | `count`, `locale`, `seed` |
| `artist` | Single artist or band name | `count`, `locale`, `seed` |
| `genre` | Single music genre | `count`, `locale`, `seed` |

Pick `profile` when a screen needs related catalogue fields together. Pick a single method when a parser, tag or column expects one shape per record.

## What to watch for

* **Count outside `1` to `100`.** One request returns up to 100 records. Call the endpoint again for larger datasets.
* **Method not matching the field under test.** Use `profile` for related fields together, or pick one method when a parser expects a single value shape.
* **Treating fixtures as licensed catalogue rows.** Generated values are synthetic strings. Replace them before publishing marketing copy, app store listings or production catalogue data.
* **Locale assumptions.** Most vocabulary is English-coded today. Send a non-English locale only after confirming upstream support for the words you need.
* **Unseeded snapshots.** Send a numeric `seed` when tests assert exact strings or snapshot the rendered output.

## FAQs

> [accordion] What is a music data generator?
>
> A music data generator creates synthetic album, artist, genre and song
> name values for tests, examples and seed scripts. Spotzee returns those
> fields from one endpoint with optional locale and seed metadata.

> [accordion] Can I get just a song name or album name?
>
> Yes. Pick `songName` for a single song name per record, or `album` for a
> single album title. Choose `profile` when you need the bundled album,
> artist, genre and song name together.

> [accordion] Is the music genre generator useful for filter screens?
>
> Yes. Pick `genre` and the endpoint returns one music genre string per
> record. Use a numeric seed when the same music genre generator output
> must repeat across runs.

> [accordion] Can I reproduce the same music records?
>
> Yes. Send a numeric `seed` and the endpoint returns the same records on
> every run. Drop the seed for fresh output each time.

> [accordion] Are these real albums, artists or songs?
>
> No. Generated values are synthetic placeholder strings built from common
> music vocabulary. Treat them as fixture copy and replace them before
> shipping documentation, marketing or production catalogue data.

> [accordion] Where can I learn more about music data generation?
>
> Read the [music data generator
> guide](https://spotzee.com/docs/guides/tools/data-generation/music-generator.md)
> for endpoint options, response fields and integration patterns. The guide
> also shows where music data fits beside book, word, string and developer
> fixture generators.

## Try it

Generate sample music data in the browser at [spotzee.com/tools/music-generator](https://spotzee.com/tools/music-generator/), or call the Extended API when you need music fixtures inside catalogue screens, search seeds, recommendation flows and demo libraries.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.