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 name generator creates synthetic first and last name pairs. The names are realistic-looking but entirely fictional — no real individuals are represented. They are designed for filling prototype UIs, seeding test databases, and generating varied fixture data for automated test suites.
Generate sample names at spotzee.com/tools/name-generator. Choose a count, locale and gender filter, then click Generate. Use this guide for locale details and integration patterns.

​
Why this matters

Placeholder names like “John Doe” and “Test User” make UIs look unfinished and fail to exercise real edge cases. Generated names with varied lengths, characters, and cultural styles reveal layout bugs, truncation issues, and sorting errors that uniform placeholders never surface. And using real names from production lists in test environments creates GDPR and CCPA exposure. Synthetic names eliminate the risk without losing the realism that makes UI reviews and integration tests meaningful. Each call to the Extended API version deducts a small per-call amount from your Spotzee credit balance. See the Spotzee pricing page for live figures.

​
How it works

1

Send the request

POST to /generic/data/generate/name with a count (1-100, as a string), an optional locale (default en), and an optional gender (male or female — omit for any).
2

Name generation

The API generates first and last names appropriate for the selected locale. The gender parameter filters first names to gender-typical forms; last names are always gender-neutral.
3

Return the records

The response always returns an array. Each record contains firstName, lastName, and fullName.

​
What to watch for

Three patterns require attention when integrating generated names.
  • Long names and layout overflow. Generated names vary in length. Test that UI containers, table columns, and labels handle long names without truncating critical information or breaking alignment.
  • Character set support. Non-English locales produce names with diacritics (é, ñ, ü, etc.). Confirm your database columns, search indexes, and sort logic handle Unicode correctly.
  • Count outside 1–100. For larger datasets, call the endpoint in a loop. Each call returns an independent set of random names.

​
FAQs

No. Names are synthetically generated and do not correspond to any real individual. They are safe to use in test and development environments without GDPR or CCPA exposure.
Yes. Pass gender=male or gender=female to restrict generated first names to gender-typical forms for the selected locale. Omit the parameter for a mix. The gender filter affects first names only — last names are gender-neutral across locales.
The web tool offers English, Spanish, French, and German. The Extended API also accepts pt_BR (Brazilian Portuguese) and zh_CN (Simplified Chinese). Unsupported locale codes fall back to en.
Call the endpoint multiple times in a loop. Each call returns an independent random set of names with no pagination or cursor needed.
Read the name generator guide for locale and character set details, then combine with the person generator guide and contact generator guide to build complete test datasets.

​
Try it

Generate sample names at spotzee.com/tools/name-generator. For batch or programmatic use, call the Extended API endpoint directly with your Spotzee API key.