Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

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.
Generate sample book data at 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. Each Extended API call deducts a small per-call amount from your Spotzee credit balance. See the Spotzee pricing page 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

MethodOutputMain parameters
profileExpanded book recordcount, locale, seed
titleBook title fixturecount, locale, seed
authorAuthor fixturecount, locale, seed
genreGenre fixturecount, locale, seed
publisherPublisher fixturecount, locale, seed
seriesSeries fixturecount, locale, seed
formatFormat fixturecount, 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

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.
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.
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.
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.
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.
Read the book data generator guide 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, or call the Extended API when you need book fixtures inside automated tests and seed scripts.