Username Generator API Documentation

📖 Overview

The Username Generator API creates unique usernames by combining words from various themed categories. Perfect for user registration systems, game character names, or any application requiring creative username suggestions.

🆕 What's New in v2.1

🎨 Multi-Theme Selection

Select multiple themes simultaneously using the new themes array parameter

🔄 Backward Compatibility

Legacy theme parameter still supported for single-theme selection

🧹 Cleaner Interface

Removed unused use_case parameter for simpler API

📚 Enhanced Themes

9 comprehensive themes with thousands of curated words

🎭 9 Comprehensive Themes

Fantasy, Professional, Science, Tech, Chemistry, Things, Health, Nature, and Space-Time themed word sets

🔄 Multi-Theme Selection

Select multiple themes simultaneously for diverse combinations

📚 Rich Word Database

100+ general adjectives plus thousands of themed words across all categories

📊 Bulk Generation

Generate up to 50 usernames in a single request

🎨 Available Themes

🧙 Fantasy

Epic and mythical usernames for gaming (Epic, Shadow, Warrior, Dragon, Wizard)

💼 Professional

Business and LinkedIn-ready usernames (Smart, Expert, Developer, Manager, Director)

🔬 Science and Space

Space exploration and scientific terms (Stellar, Galaxy, Quantum, Atom, Einstein)

💻 Computer Technology

Programming and tech-focused (Digital, Algorithm, Framework, Docker, JavaScript)

⚗️ Elements and Chemistry

Chemistry and periodic elements (Hydrogen, Carbon, Molecular, Crystal, Plasma)

🏠 Things

Everyday objects and items (Fork, Table, Chair, Lamp, Knife)

💪 Body and Health

Health and anatomy themed (Heart, Brain, Strong, Healthy, Muscle)

🌿 Nature

Landscape, fruits and animals (Mountain, Grape, Fox, Wolf, Banana)

⏰ Space and Time

Concepts of space and time (Metric, Meter, Hour, Space, Time, Centi)

🌐 Base URL

https://api.lorwongam.com/api/username-generator/

🔐 Authentication

No authentication required. This is a public API that can be accessed without any API keys or tokens.

📡 API Endpoints

GET /?action=themes Get Available Themes

Retrieve all available themes with descriptions.

Example Request

curl "https://api.lorwongam.com/api/username-generator/?action=themes"

Response

{
  "success": true,
  "themes": [
    "Fantasy",
    "Professional", 
    "Science and Space",
    "Computer Technology",
    "Elements and Chemistry",
    "Things",
    "Body and Health",
    "Nature",
    "Space and Time"
  ],
  "theme_descriptions": {
    "Fantasy": "Epic and mythical usernames for gaming and fantasy lovers",
    "Professional": "Suitable for business, LinkedIn, and professional networks",
    "Science and Space": "Science and space exploration themed usernames",
    "Computer Technology": "Tech and programming themed usernames",
    "Elements and Chemistry": "Science-inspired usernames with elements and compounds",
    "Things": "Everyday objects and items themed usernames", 
    "Body and Health": "Body parts and health-themed usernames",
    "Nature": "Nature-inspired usernames with plants, animals, and landscapes",
    "Space and Time": "Usernames inspired by concepts of space and time"
  }
}
                    

POST GET / Generate Username

Generate unique usernames based on specified themes and options.

Request Parameters

Parameter	Type	Required	Default	Description
`themes`	array	Optional	["Fantasy"]	NEW: Multiple theme selection - Array of themes: "Fantasy", "Professional", "Science and Space", "Computer Technology", "Elements and Chemistry", "Things", "Body and Health", "Nature", "Space and Time"
`theme`	string	Optional	"Fantasy"	Deprecated: Single theme selection (use `themes` instead)
`min_length`	integer	Optional	6	Minimum username length (3-50)
`max_length`	integer	Optional	20	Maximum username length (3-50)
`count`	integer	Optional	10	Number of usernames to generate (1-50)
`include_numbers`	boolean	Optional	false	Add random numbers to usernames
`include_symbols`	boolean	Optional	false	Add symbols like _, -, .
`capitalize`	boolean	Optional	true	Capitalize words
`avoid_repetition`	boolean	Optional	true	Avoid duplicate word combinations
`use_all_adjectives`	boolean	Optional	false	Use adjectives from all themes
`use_general_adjectives`	boolean	Optional	false	Add general adjectives (colors, shapes, sizes, etc.)
`custom_words`	string	Optional	""	Comma-separated custom words
integer	Optional	null	Maximum username length (excludes numbers)

Example Request - Multi-Theme Username (NEW)

curl -X POST "https://api.lorwongam.com/api/username-generator/" \
  -H "Content-Type: application/json" \
  -d '{
    "themes": ["Fantasy", "Computer Technology"],
    "min_length": 8,
    "max_length": 15,
    "count": 5,
    "include_numbers": true
  }'
                    

Example Request - Science & Chemistry Mix

curl -X POST "https://api.lorwongam.com/api/username-generator/" \
  -H "Content-Type: application/json" \
  -d '{
    "themes": ["Science and Space", "Elements and Chemistry"],
    "min_length": 10,
    "max_length": 18,
    "use_general_adjectives": true,
    "count": 10
  }'
                    

Example Request - Professional Username

curl -X POST "https://api.lorwongam.com/api/username-generator/" \
  -H "Content-Type: application/json" \
  -d '{
    "themes": ["Professional"],
    "min_length": 8,
    "max_length": 15,
    "capitalize": true,
    "avoid_repetition": true,
    "use_general_adjectives": true,
    "count": 8
  }'
                    

Example Request - Creative All-Theme Mix

curl -X POST "https://api.lorwongam.com/api/username-generator/" \
  -H "Content-Type: application/json" \
  -d '{
    "themes": ["Nature", "Things", "Body and Health"],
    "use_all_adjectives": true,
    "custom_words": "Dragon,Phoenix",
    "include_symbols": true,
    "count": 15
  }'
                    

Example GET Request - Multi-Theme

curl "https://api.lorwongam.com/api/username-generator/?themes=Fantasy,Professional&count=5&include_numbers=true"
                    

Example GET Request - Single Theme (Backward Compatible)

curl "https://api.lorwongam.com/api/username-generator/?theme=Nature&min_length=10&max_length=15&count=8"
                    

📊 Response Format

Success Response

Multi-Theme Username Response (NEW)

{
  "success": true,
  "data": {
    "usernames": [
      "QuantumWarrior",
      "CyberDragon",
      "StellarNinja",
      "AlgorithmKnight",
      "CosmicHunter"
    ],
    "count": 5,
    "options_used": {
      "themes": ["Fantasy", "Computer Technology"],
      "min_length": 8,
      "max_length": 15,
      "count": 5,
      "include_numbers": false,
      "include_symbols": false,
      "capitalize": true,
      "avoid_repetition": true,
      "use_all_adjectives": false,
      "use_general_adjectives": false,
      "custom_words": ""
    }
  },
  "generation_info": {
    "themes": ["Fantasy", "Computer Technology"],
    "theme_count": 2,
    "length_range": "8-15 characters",
    "features": {
      "numbers": "excluded",
      "symbols": "excluded",
      "capitalization": "enabled"
    }
  },
  "timestamp": "2025-09-11 12:34:56"
}
                    

Science & Chemistry Mix Response

{
  "success": true,
  "data": {
    "usernames": [
      "AtomicNebula",
      "MolecularQuasar", 
      "CrystallineGalaxy",
      "HydrogenStar",
      "QuantumCarbon"
    ],
    "count": 5,
    "options_used": {
      "themes": ["Science and Space", "Elements and Chemistry"],
      "min_length": 10,
      "max_length": 18,
      "use_general_adjectives": true,
      "count": 5
    }
  },
  "generation_info": {
    "themes": ["Science and Space", "Elements and Chemistry"],
    "theme_count": 2,
    "length_range": "10-18 characters",
    "features": {
      "numbers": "excluded",
      "symbols": "excluded", 
      "capitalization": "enabled"
    }
  },
  "timestamp": "2025-09-11 14:22:15"
}
                    

Error Response

{
  "success": false,
  "error": "Validation failed",
  "messages": [
    "Invalid theme selected: invalidtheme"
  ]
}
                    

🎯 Format Options

Format	Structure	Example
`adjective_noun`	Adjective + Noun	swift_panther
`noun_adjective`	Noun + Adjective	panther_swift
`noun_only`	Noun only	panther

Case Style Options

Style	Description	Example
`lowercase`	All lowercase	swift_panther
`uppercase`	All uppercase	SWIFT_PANTHER
`title`	First letter of each word capitalized	Swift_Panther
`camel`	CamelCase (no separators)	SwiftPanther

⚠️ Error Codes

Code	Description
`INVALID_THEME`	Theme parameter is not valid
`INVALID_FORMAT`	Format parameter is not valid
`INVALID_CASE_STYLE`	Case style parameter is not valid
`INVALID_COUNT`	Count is outside the valid range (1-20)
`GENERATION_ERROR`	Error occurred during username generation

🚦 Rate Limits

Currently, there are no rate limits imposed on this API. However, please use it responsibly and avoid excessive requests that might impact service availability for other users.

👤 Username Generator API