🚀 Quick Start Guide

Start earning with EmojiHouse in under 5 minutes

⚡

Sub-5ms API

Lightning fast responses

💰

62-70% Share

You keep most revenue

🔒

Privacy-First

No tracking required

Step 1: Get Your API Key

If you haven't already, generate your API key from the dashboard:

🔑 Get Your API Key

⚠️ Keep Your Key Secure

Never commit keys to version control
Use environment variables in production
Regenerate if compromised

Step 2: Make Your First API Call

📡 Using cURL

Test your API key with this simple command:

curl -X POST https://api.emojihouse.com/ml/predict \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "session_data": {
      "user_engagement": 0.75,
      "session_duration": 120,
      "scroll_depth": 0.8,
      "interaction_count": 15
    }
  }'

✅ Expected Response:

{
  "emoji_score": 87.5,
  "trust_level": "high",
  "revenue_attribution": 0.0325,
  "processing_time_ms": 2.3,
  "attribution_confidence": 0.89,
  "recommendation": "high_value_user"
}

🟨 JavaScript / Node.js

Integrate into your web or Node.js application:

// Using fetch API
const response = await fetch('https://api.emojihouse.com/ml/predict', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.EMOJIHOUSE_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    session_data: {
      user_engagement: 0.75,
      session_duration: 120,
      scroll_depth: 0.8,
      interaction_count: 15
    }
  })
});

const result = await response.json();

console.log('EmojiScore:', result.emoji_score);  // 87.5
console.log('You earned:', result.revenue_attribution);  // $0.0325
console.log('Trust level:', result.trust_level);  // "high"

// Use the score to personalize user experience
if (result.emoji_score > 80) {
  showPremiumContent();
} else {
  showStandardContent();
}

🐍 Python

Perfect for ML pipelines and backend services:

import requests
import os

# Load API key from environment
API_KEY = os.environ.get('EMOJIHOUSE_API_KEY')

# Make prediction request
response = requests.post(
    'https://api.emojihouse.com/ml/predict',
    headers={
        'X-API-Key': API_KEY,
        'Content-Type': 'application/json'
    },
    json={
        'session_data': {
            'user_engagement': 0.75,
            'session_duration': 120,
            'scroll_depth': 0.8,
            'interaction_count': 15
        }
    }
)

result = response.json()

print(f"EmojiScore: {result['emoji_score']}")  # 87.5
print(f"You earned: ${result['revenue_attribution']}")  # $0.0325
print(f"Trust level: {result['trust_level']}")  # "high"

# Use the score for decision making
if result['emoji_score'] > 80:
    segment = 'high_value'
else:
    segment = 'standard'

Step 3: Understanding Revenue

💰 Billable Endpoints

These generate revenue for you:

/api/ml/predict - $0.05/call
/api/ml/analyze - $0.05/call
/api/ml/score - $0.05/call
/api/emojiscore/analyze - $0.05/call

🆓 Free Endpoints

No charge, use freely:

/health/ready - Health check
/api/status - API status
/dashboard/* - Dashboard pages

💵 Your Earnings Per Call

$0.031

Starter (62%)

$0.0325

Growth (65%)

$0.034

Enterprise (68%)

$0.035

Scale (70%)

Based on $0.05 per ML API call. View full pricing →

Step 4: Monitor Your Earnings

Track your API usage and revenue in real-time:

📊 View Dashboard

📈 What You'll See:

✅ Total API calls made
✅ Revenue generated per key
✅ Your earnings (after platform fee)
✅ Current subscription tier
✅ Volume discount progress

🔧 Error Handling

401 Unauthorized

{"error": "Invalid API key", "message": "API key not found"}

Fix: Check your API key is correct and active in the dashboard.

429 Rate Limit Exceeded

{"error": "Rate limit exceeded", "retry_after": 60}

Fix: Wait before retrying. Default limit: 1000 requests/hour. Upgrade for higher limits.

400 Bad Request

{"error": "Invalid request", "message": "Missing required field: session_data"}

Fix: Ensure your request includes all required fields.