H
Helionova

API Documentation

v1.0.0

Complete API reference for HelioNova Studios. Integrate our AI-powered content creation and brand development tools into your applications.

Quick Start

Base URL

Authentication

Include your API key in the Authorization header:Authorization: Bearer YOUR_API_KEY

API Endpoints

POST/api/hashtags/generateactive

Generate strategic hashtags using OpenAI API (Direct Integration)

Parameters

input(string)Required

Response

{
  "data": [
    {
      "tag": "#BrandName",
      "reason": "Strategic reasoning including psychology, market analysis, and performance prediction"
    }
  ],
  "framework": {
    "audience_discovery": "Audience psychology analysis",
    "brand_alignment": "Brand psychology-hashtag alignment",
    "architecture": "Strategic hashtag architecture",
    "platform_optimization": "Platform optimization strategies",
    "performance_prediction": "Performance prediction with optimization frameworks",
    "implementation": "4-week implementation checklist"
  }
}
POST/api/emojis/generateactive

Generate emoji strategy using OpenAI API (Direct Integration)

Parameters

input(string)Required

Response

{
  "data": [
    {
      "text": "Strategy Analysis: Detailed psychological analysis..."
    }
  ],
  "emojiStrategy": {
    "recommendations": [
      {
        "emoji": "💻",
        "name": "Laptop",
        "meaning": "Technology, software, digital tools",
        "combos": ["💻🧠", "💻⚡", "💻🚀"],
        "useCases": ["Smart tools", "Quick solutions"],
        "category": "industry",
        "relevance": 9
      }
    ],
    "strategy": {
      "industry_analysis": "Audience psychology analysis",
      "brand_mapping": "Brand psychology-emoji alignment",
      "psychological_rationale": "Strategic emoji architecture",
      "platform_optimization": "Platform optimization strategies",
      "implementation_guide": "Performance prediction frameworks",
      "strategic_combinations": "Implementation checklist"
    },
    "combinations": [
      "🔒📦 = Secure delivery",
      "🛠️💡 = Build your next idea"
    ]
  }
}
POST/api/story-time-tiktokactive

Generate TikTok story time video scripts from any input (text, blog, PDF, or TikTok URL)

Parameters

input(string)Required
duration(string)
niche(string)

Response

{
  "success": true,
  "script": {
    "duration": "3 minutes",
    "hook": "I cannot believe I'm sharing this [niche] hack for free...",
    "checklist": [
      "Extract key insights from input material",
      "Identify compelling narrative arc",
      "Select optimal psychological hook",
      "Structure story with engaging beats",
      "Add call-to-action and engagement elements"
    ],
    "content": "Full TikTok story time script with personalized hooks, narrative structure, and engagement elements...",
    "hashtags": ["#StoryTime", "#NicheHack", "#ViralTip"],
    "engagement_tips": [
      "Use trending audio",
      "Add text overlays",
      "Include visual cues",
      "End with strong CTA"
    ]
  },
  "metadata": {
    "processingTime": 8.5,
    "wordCount": 450,
    "hookType": "Psychological Trigger",
    "targetAudience": "Auto-detected from input"
  }
}
POST/api/content/strategybeta

Generate comprehensive content strategy

Parameters

brand_identity(object)Required
goals(array)Required
platforms(array)Required

Response

{
  "success": true,
  "content_strategy": {
    "pillars": [
      "Educational content",
      "Behind-the-scenes",
      "User-generated content",
      "Industry insights"
    ],
    "content_calendar": {
      "frequency": "3 posts per week",
      "best_times": ["9:00 AM", "12:00 PM", "6:00 PM"],
      "content_mix": {
        "educational": 40,
        "entertainment": 30,
        "promotional": 20,
        "user_generated": 10
      }
    },
    "platform_strategies": {
      "instagram": "Visual storytelling focus",
      "tiktok": "Trending content and challenges",
      "linkedin": "Professional insights and thought leadership"
    }
  }
}

API Testing

API Keys

Production Key

active

API Key

helionova_prod_1234567890abcdef...

Permissions

content:readcontent:writeanalytics:readbrand:readbrand:write
Created: 2024-01-15Last used: 2 hours ago

Development Key

active

API Key

helionova_dev_abcdef1234567890...

Permissions

content:readhashtags:analyzebrand:read
Created: 2024-01-10Last used: 1 day ago

Analytics Key

active

API Key

helionova_analytics_fedcba0987654321...

Permissions

analytics:readtrends:read
Created: 2024-01-05Last used: 30 minutes ago

Rate Limits & Quotas

1,000
Requests per hour
10,000
Requests per day
100MB
File upload limit

SDKs & Libraries

JavaScript/TypeScript

npm install @helionova/api
Official SDK for Node.js and browser environments

Python

pip install helionova
Python client library for data science workflows