Skip to content

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 (or Authorization: Bearer YOUR_API_KEY)
  • Supported lang values: 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": ""
  }
}

Open Dashboard


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.