Developer Getting Started

1

Get Your API Key

1. Sign up for a developer account
2. Verify your email address
3. Go to Dashboard → API Keys
4. Click "Generate New API Key"
5. Copy your key (starts with eh_live_...)

🔒 Security: Keep your API key secure. Never expose it in client-side code or commit it to public repositories.

2

Choose Your Integration Method

🌐 REST API (Recommended)

Direct HTTP requests. Works with any language.

✅ Maximum flexibility
✅ Works server-side
✅ Full control

📦 SDK Integration

Pre-built libraries for iOS, Android, Web.

✅ Faster setup
✅ Built-in retry logic
✅ Auto-updates

3

Make Your First API Call

JavaScript (Node.js)

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

const result = await response.json();
console.log('EmojiScore:', result.emoji_score);
console.log('You earned:', result.revenue_attribution);

Python

import requests

response = requests.post(
    'https://api.emojihouse.com/api/ml/predict',
    headers={'X-API-Key': 'your_api_key_here'},
    json={
        'session_data': {
            'user_engagement': 0.75,
            'session_duration': 180,
            'scroll_depth': 0.8,
            'interaction_count': 15
        }
    }
)

result = response.json()
print(f"EmojiScore: {result['emoji_score']}")
print(f"You earned: ${result['revenue_attribution']}")

cURL (Testing)

curl -X POST https://api.emojihouse.com/api/ml/predict \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "session_data": {
      "user_engagement": 0.75,
      "session_duration": 180
    }
  }'

4