title: Username Numerology API Endpoint description: Developer documentation for the Username Numerology endpoint in The Numerology API: username numerology and creator brand energy, request parameter options, authentication, multilingual JSON responses, and production-ready examples. Extended endpoints are available only on the direct Numerology API platform (RapidAPI gateway not supported).
Username Numerology¶
The Username Numerology endpoint returns enterprise numerology output for username numerology and creator brand energy. Use this page for integration-ready parameter rules, allowed options, and response examples.
Endpoint¶
| Method | Path |
|---|---|
GET | https://api.numerologyapi.com/api/v1/username-numerology |
POST | https://api.numerologyapi.com/api/v1/username-numerology |
Availability¶
- Authentication:
X-API-Key(orAuthorization: Bearer YOUR_API_KEY) - Supported
langvalues:en,fr,es,de,pt,ja,hi,ar,ru,tr,it,pl,nl,id,ko,th,ro,ur,gu,bn,vi,ta,te,mr,pa,zh - Access channel: direct API (
https://api.numerologyapi.com) - RapidAPI gateway: Not currently supported for extended endpoints
Parameters¶
GET Query Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
username | string | Yes | — | length 1..60 | Username or social handle to analyze |
lang | string | No | en | en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh | Response language (supported: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh) |
num_sys | string | No | pythagorean | pythagorean, chaldean, vedic | Optional numerology system. Supported values: pythagorean, chaldean, vedic. Defaults to pythagorean. |
POST Query Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
lang | string | No | en | en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh | Response language (supported: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh) |
POST Body Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
username | string | Yes | — | length 1..60 | Username or social handle to analyze. |
num_sys | string | No | pythagorean | pythagorean, chaldean, vedic | Optional numerology system. Supported values: pythagorean, chaldean, vedic. Defaults to pythagorean. |
Response Example¶
Response Example
{
"numerology_system": "pythagorean",
"username": "john_doe",
"normalized_username": "john_doe",
"letters_only": "JOHNDOE",
"digits_only": "",
"username_number": 8,
"username_total": 35,
"audience_desire_number": 8,
"public_persona_number": 9,
"hidden_passion_numbers": [
5,
6
],
"primary_hidden_passion": 5,
"missing_numbers": [
2,
3,
7,
9
],
"first_letter_value": 1,
"first_letter_energy": 1,
"digit_sum_in_username": 0,
"master_vibration": {
"is_master_number": false,
"master_number_value": null
},
"brand_tone": "Premium, powerful, success-oriented",
"visibility_energy": "Executive premium visibility",
"creator_fit": "Excellent for premium business, finance, and authority creators",
"scores": {
"public_magnetism": 60,
"audience_attraction": 60,
"brand_tone_strength": 70,
"visibility_energy_score": 62,
"authority_score": 77
},
"overall_creator_score": 64,
"letter_breakdown": [
{
"letter": "J",
"value": 1
},
{
"letter": "O",
"value": 6
},
{
"letter": "H",
"value": 8
},
{
"letter": "N",
"value": 5
},
{
"letter": "D",
"value": 4
},
{
"letter": "O",
"value": 6
},
{
"letter": "E",
"value": 5
}
],
"meaning": {
"title": "Username Number 8: Premium Presence, Power & Market Authority",
"overview": "A Number 8 username gives off ambition, status, success, power, executive strength, and premium positioning. In the creator economy, this can be highly effective for creators building serious brands, premium businesses, business authority, luxury visibility, or results-oriented platforms. It often carries strong monetization energy.",
"core_creator_energy": "Powerful • Premium • Strategic • Authoritative • Successful",
"public_magnetism": "This handle can feel commanding, polished, and serious. It tends to make people view the creator as someone with business acumen, status potential, or a premium standard.",
"audience_attraction_style": "It attracts audiences drawn to power, success, discipline, premium branding, money energy, leadership, and business-minded influence.",
"brand_tone": "Premium, strategic, confident, executive, success-oriented",
"visibility_energy": "High for premium brand building, business credibility, monetization, and authority-led growth. This is especially powerful for expert and business creators.",
"best_for": [
"Business creators, finance creators, premium coaches, founders, consultants, and luxury lifestyle creators",
"Creator brands with serious monetization goals",
"Authority-driven personal brands",
"Pages built around results, power, and influence"
],
"content_strengths": [
"Strong monetization and premium perception",
"Authority-based content positioning",
"Executive and commercial trust energy",
"High-value audience attraction"
],
"watch_out": [
"Can feel intimidating or transactional if the creator lacks warmth",
"May appear too polished or status-driven without authenticity",
"Needs integrity so power feels trustworthy",
"Can overemphasize success image at the expense of emotional connection"
],
"growth_tip": "Use this handle to signal premium standards, competence, and seriousness. Let your content prove that the authority is real.",
"spiritual_creator_message": "This username carries material mastery energy. It reminds you that power becomes magnetic when it is guided by discipline, integrity, and wise stewardship.",
"affirmation": "My presence is powerful, premium, and aligned with success. I build influence with integrity."
},
"detailed_meaning": "8 resonates with power, abundance, and executive success—making it perfect for business coaches, entrepreneurs, finance influencers, or luxury brands. This name signals authority, efficiency, and results; followers perceive the account as successful, influential, and capable. It thrives in environments requiring monetization, large-scale management, or strategic dominance. However, the shadow side includes greed, workaholism, or a reputation for being too aggressive or salesy; care must be taken to balance profit with ethics and audience well-being. To harmonize, focus on sustainable growth and fair value exchange. When honored, a Username 8 becomes a symbol of achievement—proving that your brand delivers tangible results and that success is measurable and attainable.",
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "ae5132a4990ab4bf",
"quota": "unlimited",
"usage_tracking": true,
"creator_economy_analysis": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.2",
"endpoint_name": "username_numerology",
"endpoint_description": "Analyzes a username or social handle to reveal public magnetism, audience attraction, brand tone, and visibility energy.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-08-17T17:53:27.850295+01:00",
"data_source": "Internal Engine",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"fr",
"es",
"de",
"pt",
"ja",
"hi",
"ar",
"ru",
"tr",
"it",
"pl",
"nl",
"id",
"ko",
"th",
"ro",
"ur",
"gu",
"bn",
"vi",
"ta",
"te",
"mr",
"pa",
"zh"
],
"notes": ""
}
}
Note
This endpoint belongs to the Extended suite and is available through direct API access at https://api.numerologyapi.com. It is currently not supported via the RapidAPI gateway.