> ## 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.

# Synthetic Book Data Generator

> Generate book title, author, genre, publisher, series and format fixtures with count, locale, seed and method controls for repeatable QA and content tests.

A synthetic book data generator creates sample data for titles, authors, genres, publishers, series and format fields. It gives product, content and QA teams repeatable book-shaped data for catalogues, publishing workflows, CMS previews and sample datasets without copying customer or operational records.

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

## Why this matters

Book-shaped data appears in catalogue pages, editorial workflows, search facets, recommendation demos and import tests. Those surfaces need varied values that exercise layout, sorting, filtering and validation behaviour.

Static title lists are easy to start with. But they become a hidden test dependency once every fixture uses the same few authors, genres and publishers.

Generated book data is test fixture data only. It is not a verified bibliography, licensed content source or production catalogue. 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/book` with `count`. The count is a string
from `1` to `100`.

**2. Choose a method**

Use `method=profile` for expanded book records, or choose one field method
such as `title`, `author`, `genre`, `publisher`, `series` or `format`.

**3. Set repeatability**

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

**4. Read the response**

The response returns `data.books[]`, `generated`, `locale`, optional `seed`,
and the resolved `method`. Profile records can include title, author, genre,
publisher, series and format fields.

## Method reference

| Method | Output | Main parameters |
| - | - | - |
| `profile` | Expanded book record | `count`, `locale`, `seed` |
| `title` | Book title fixture | `count`, `locale`, `seed` |
| `author` | Author fixture | `count`, `locale`, `seed` |
| `genre` | Genre fixture | `count`, `locale`, `seed` |
| `publisher` | Publisher fixture | `count`, `locale`, `seed` |
| `series` | Series fixture | `count`, `locale`, `seed` |
| `format` | Format fixture | `count`, `locale`, `seed` |

Use `profile` when you need fuller book test data. Use a field method when your form, table, parser or import job only needs one value type.

## What to watch for

* **Count outside `1` to `100`.** One request generates up to 100 book records. For more rows, call the endpoint again and vary the seed when you need a different batch.
* **Wrong method for the fixture.** Use `profile` for many book fields together, or a field method when the consuming test only expects one scalar value.
* **Seed not repeating.** The seed must be numeric. Keep the same count, locale, method and seed when tests need stable fixture values.
* **Unexpected profile fields.** `profile` can return title, author, genre, publisher, series and format together. Use a field method when one column or form field is under test.
* **Assuming real catalogue data.** Generated book values are synthetic sample data. Do not treat them as verified bibliographic records, licensed content or production catalogue entries.

## FAQs

> [accordion] What can a book data generator return?
>
> A book data generator can return `books[]` records with `method` and
> `value` fields. Profile output can also include `title`, `author`, `genre`,
> `publisher`, `series` and `format` fields.

> [accordion] Can I use this as a random book generator?
>
> Yes. Choose a method and count, then generate one or more synthetic book
> values. Add a numeric seed when the same random book generator output must
> repeat in tests.

> [accordion] Can I generate only book titles?
>
> Yes. Use `method=title` when a form, search result, card component or parser
> only needs title-shaped sample values. Use `profile` when a fixture needs
> title, author and supporting fields together.

> [accordion] Can I reproduce book data generator output?
>
> Yes. Set a numeric seed to reproduce output for the same count, locale and
> method values. Leave the seed blank when you want a fresh random batch for
> exploratory QA.

> [accordion] Can I use it as a book author generator?
>
> Yes. Use `method=author` when tests need author-shaped sample values without
> full book profiles. Use a seed when a fixture must stay stable across
> repeated test runs.

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

## Try it

Generate sample book data in the browser at [spotzee.com/tools/book-generator](https://spotzee.com/tools/book-generator/), or call the Extended API when you need book fixtures inside automated tests and seed scripts.


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