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