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,es,de,fr,pt - 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, es, de, fr, pt | Response language (supported: en, es, de, fr, pt) |
POST Query Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
lang | string | No | en | en, es, de, fr, pt | Response language (supported: en, es, de, fr, pt) |
POST Body Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
username | string | Yes | — | length 1..60 | Username or social handle to analyze. |
Response Example¶
GET¶
{
"username": "test",
"normalized_username": "test",
"letters_only": "TEST",
"digits_only": "",
"username_number": 1,
"username_total": 10,
"audience_desire_number": 5,
"public_persona_number": 5,
"hidden_passion_numbers": [
2
],
"primary_hidden_passion": 2,
"missing_numbers": [
3,
4,
6,
7,
8,
9
],
"first_letter_value": 2,
"first_letter_energy": 2,
"digit_sum_in_username": 0,
"master_vibration": {
"is_master_number": false,
"master_number_value": null
},
"brand_tone": "Bold, direct, leader-like",
"visibility_energy": "High bold visibility",
"creator_fit": "Excellent for bold personal brands and leadership creators",
"scores": {
"public_magnetism": 78,
"audience_attraction": 72,
"brand_tone_strength": 80,
"visibility_energy_score": 72,
"authority_score": 69
},
"overall_creator_score": 74,
"letter_breakdown": [
{
"letter": "T",
"value": 2
},
{
"letter": "E",
"value": 5
},
{
"letter": "S",
"value": 1
},
{
"letter": "T",
"value": 2
}
],
"meaning": {
"title": "Username Number 1: Bold Visibility & Leader Energy",
"overview": "A username with the Number 1 vibration projects independence, confidence, originality, and strong first-impression energy. In the creator economy, this kind of handle tends to feel assertive, memorable, and self-led. It is especially powerful for creators who want to stand out as pioneers, thought leaders, founders, or bold personalities rather than blend into trends.",
"core_creator_energy": "Bold • Independent • Direct • Confident • Trailblazing",
"public_magnetism": "This handle creates a strong impression quickly. It can signal leadership, clarity, and self-belief, making people feel they are looking at someone who knows their value and direction.",
"audience_attraction_style": "It tends to attract audiences who respond to confidence, originality, decisiveness, and strong personal identity. Followers may see the creator as someone worth watching because they appear to move first rather than imitate.",
"brand_tone": "Sharp, self-assured, ambitious, direct, founder-like",
"visibility_energy": "High for bold personal branding, strong opinions, trend leadership, and identity-driven content. This number often works well when the creator wants to own a lane or become the face of a niche.",
"best_for": [
"Founders, entrepreneurs, coaches, and authority creators",
"Opinion-led creators with a strong point of view",
"Motivational, leadership, and personal branding accounts",
"Creators building premium or high-confidence positioning"
],
"content_strengths": [
"Strong first-impression content",
"Leadership-based messaging",
"Premium personal branding",
"Launches, declarations, and directional storytelling"
],
"watch_out": [
"Can feel too forceful or self-focused if warmth is missing",
"May intimidate softer audiences if the tone becomes overly dominant",
"Needs consistency so confidence feels grounded, not performative",
"Can overemphasize image over emotional relatability"
],
"growth_tip": "Use this handle to establish a clear identity fast. Let your content communicate leadership, originality, and personal conviction.",
"spiritual_creator_message": "This username carries initiation energy. It asks you to lead visibly, trust your voice, and create from your own center rather than from imitation.",
"affirmation": "My presence is bold, clear, and unforgettable. I lead by being fully myself."
},
"detailed_meaning": "1 vibrates with the energy of digital leadership, originality, and independent branding—making it ideal for influencers, pioneers, or solo entrepreneurs aiming to stand out in a crowded feed. This name signals confidence, uniqueness, and a willingness to set trends rather than follow them; followers perceive the account as bold, decisive, and authoritative. It supports content that requires strong personal branding, innovative ideas, or being the first to cover a topic. However, the shadow side includes coming across as overly aggressive, self-centered, or isolated from the community; care must be taken not to alienate followers with impatience or ego. To harmonize, ensure your content encourages initiative while remaining open to comments and feedback. When honored, a Username 1 becomes a beacon of individuality—proving that your digital presence is a leader capable of carving its own path without waiting for validation.",
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "c026cda4233d0539",
"quota": "unlimited",
"usage_tracking": true,
"creator_economy_analysis": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"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-03-28T14:38:15.898179+01:00",
"data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"es",
"de",
"fr",
"pt"
],
"notes": ""
}
}
¶
{
"username": "test",
"normalized_username": "test",
"letters_only": "TEST",
"digits_only": "",
"username_number": 1,
"username_total": 10,
"audience_desire_number": 5,
"public_persona_number": 5,
"hidden_passion_numbers": [
2
],
"primary_hidden_passion": 2,
"missing_numbers": [
3,
4,
6,
7,
8,
9
],
"first_letter_value": 2,
"first_letter_energy": 2,
"digit_sum_in_username": 0,
"master_vibration": {
"is_master_number": false,
"master_number_value": null
},
"brand_tone": "Bold, direct, leader-like",
"visibility_energy": "High bold visibility",
"creator_fit": "Excellent for bold personal brands and leadership creators",
"scores": {
"public_magnetism": 78,
"audience_attraction": 72,
"brand_tone_strength": 80,
"visibility_energy_score": 72,
"authority_score": 69
},
"overall_creator_score": 74,
"letter_breakdown": [
{
"letter": "T",
"value": 2
},
{
"letter": "E",
"value": 5
},
{
"letter": "S",
"value": 1
},
{
"letter": "T",
"value": 2
}
],
"meaning": {
"title": "Username Number 1: Bold Visibility & Leader Energy",
"overview": "A username with the Number 1 vibration projects independence, confidence, originality, and strong first-impression energy. In the creator economy, this kind of handle tends to feel assertive, memorable, and self-led. It is especially powerful for creators who want to stand out as pioneers, thought leaders, founders, or bold personalities rather than blend into trends.",
"core_creator_energy": "Bold • Independent • Direct • Confident • Trailblazing",
"public_magnetism": "This handle creates a strong impression quickly. It can signal leadership, clarity, and self-belief, making people feel they are looking at someone who knows their value and direction.",
"audience_attraction_style": "It tends to attract audiences who respond to confidence, originality, decisiveness, and strong personal identity. Followers may see the creator as someone worth watching because they appear to move first rather than imitate.",
"brand_tone": "Sharp, self-assured, ambitious, direct, founder-like",
"visibility_energy": "High for bold personal branding, strong opinions, trend leadership, and identity-driven content. This number often works well when the creator wants to own a lane or become the face of a niche.",
"best_for": [
"Founders, entrepreneurs, coaches, and authority creators",
"Opinion-led creators with a strong point of view",
"Motivational, leadership, and personal branding accounts",
"Creators building premium or high-confidence positioning"
],
"content_strengths": [
"Strong first-impression content",
"Leadership-based messaging",
"Premium personal branding",
"Launches, declarations, and directional storytelling"
],
"watch_out": [
"Can feel too forceful or self-focused if warmth is missing",
"May intimidate softer audiences if the tone becomes overly dominant",
"Needs consistency so confidence feels grounded, not performative",
"Can overemphasize image over emotional relatability"
],
"growth_tip": "Use this handle to establish a clear identity fast. Let your content communicate leadership, originality, and personal conviction.",
"spiritual_creator_message": "This username carries initiation energy. It asks you to lead visibly, trust your voice, and create from your own center rather than from imitation.",
"affirmation": "My presence is bold, clear, and unforgettable. I lead by being fully myself."
},
"detailed_meaning": "1 vibrates with the energy of digital leadership, originality, and independent branding—making it ideal for influencers, pioneers, or solo entrepreneurs aiming to stand out in a crowded feed. This name signals confidence, uniqueness, and a willingness to set trends rather than follow them; followers perceive the account as bold, decisive, and authoritative. It supports content that requires strong personal branding, innovative ideas, or being the first to cover a topic. However, the shadow side includes coming across as overly aggressive, self-centered, or isolated from the community; care must be taken not to alienate followers with impatience or ego. To harmonize, ensure your content encourages initiative while remaining open to comments and feedback. When honored, a Username 1 becomes a beacon of individuality—proving that your digital presence is a leader capable of carving its own path without waiting for validation.",
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "c026cda4233d0539",
"quota": "unlimited",
"usage_tracking": true,
"creator_economy_analysis": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"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-03-28T14:38:15.898179+01:00",
"data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"es",
"de",
"fr",
"pt"
],
"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.