API Documentation v1.0

User Generator API

User Generator API Generate realistic, privacy-safe user profiles programmatically — names, real addresses sourced from Google Maps, emails, phone numbers, usernames, passwords, and payment BINs — all in a single API call. Whether you're building a test suite, populating a staging database, or automating account workflows, the UGener API gives you clean, structured JSON data on demand. What the API Gives You Each API call returns a complete user profile — ready to drop straight into yo

User Generator API

Generate realistic, privacy-safe user profiles programmatically — names, real addresses sourced from Google Maps, emails, phone numbers, usernames, passwords, and payment BINs — all in a single API call.

Whether you're building a test suite, populating a staging database, or automating account workflows, the UGener API gives you clean, structured JSON data on demand.


What the API Gives You

Each API call returns a complete user profile — ready to drop straight into your application:

  • Full name — first and last, randomized
  • Date of birth — within your specified age range
  • Real address — sourced from Google Maps (not made-up strings)
  • Email addresses — Gmail and Outlook variants, freshly generated
  • Phone number — fake and real-format options
  • Username & password — full and short variants, configurable length
  • Payment BIN — for payment form testing

Everything is synthetic. No real person's data is ever used or stored.


Built for Developers

The UGener API is a RESTful endpoint — a simple GET request with optional query parameters:

  • Filter by gender — male, female, or random
  • Set age range — narrow the generated profile to a specific bracket
  • Custom password length — meet your app's password policy requirements
  • Custom email domain — generate emails under any domain you specify

Full parameter reference, request examples (cURL, JavaScript, Python), and response schema are in the documentation.

View full API documentation


How Authentication Works

The UGener API uses the SONJJ API Credit system — a shared, pay-as-you-go pool across all SONJJ API products.

To get started:

  1. Create an account at my.sonjj.com
  2. Copy your X-Api-Key from the API section
  3. Add it as a request header: X-Api-Key: your-key-here
  4. Each successful call deducts credits from your balance

Credits never expire. You top up when you need more.

Get your API key
See pricing & credit plans


Common Use Cases

QA & Software Testing
Populate test databases, simulate new user registrations, and stress-test onboarding flows with diverse, realistic profiles — without touching real user data.

UI/UX Design & Prototyping
Generate believable personas for mockups and design reviews. Real-looking names and addresses make prototype demos far more convincing.

Automation & Scripting
Integrate into CI/CD pipelines or data pipeline scripts. Generate bulk profiles on demand without maintaining your own fake-data library.

Data Science & Market Research
Seed synthetic datasets for model training, segmentation exercises, or customer journey simulations — all GDPR-safe.

Creative & Narrative Work
Writers, game designers, and screenwriters use it to quickly generate character profiles with a realistic identity baseline.


FAQ

Is this legal to use?
Yes. All generated data is entirely synthetic — no real individuals are represented. The API is designed for legitimate testing, development, and privacy-protective use cases. See our Terms of Service and Privacy Policy.

Can I generate data in bulk?
Yes. Call the endpoint in a loop or batch script. Each request returns one profile — there's no hard cap on total requests, only your credit balance.

What's the difference between the web tool and the API?
The web tool at ugener.com is for manual, one-at-a-time generation. The API is for programmatic, automated generation at any scale — integrated directly into your code.

Are real addresses actually real?
Yes — the address_real field returns coordinates and street data sourced from Google Maps, which makes it useful for address field validation and map integration testing.

Where do I find request examples and the full response schema?
In the centralized docs — it covers all parameters, headers, example requests in multiple languages, and the full response object.

What if I run out of credits?
Your requests will return an error response. Top up at any time from your dashboard — no subscription required.


Start Using the API

Step Link
📖 Full documentation sonjj.com/docs/?brand=ugener.com
💳 Pricing & credit plans sonjj.com/pricing/
🔑 Get your API key my.sonjj.com