Mood API

{ "mood": "happy", "score": 0.7191, "emoji": "😊", "reasons": [ "anchor: 'amazing'" ], "raw_vector": { "happy": 3.2, "angry": 0, "sad": 0, "fearful": 0, "surprised": 0, "disgusted": 0 } }

How it works

📤

1. Send a request
Make a POST request with a string of text + your API Key

🧠

2. Process text
The engine scores your text and detects the dominant mood.

📦

3. Get structured output
Receive a JSON response with mood, confidence score, emoji, and reasoning

POST /analyze

    {
    "text": "I love this product!"
    }

    →

    {
    "mood": "happy",
    "score": 0.7739,
    "emoji": "😊"
    }

Examples

Single Request

curl -X POST https://mood-6421db30.fastapicloud.dev/analyze \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @data.json

{
  "text": "I can't believe they did this to me after everything!!!",
  "include_emoji": true,
  "include_reasons": false
}

---


{
  "mood":"surprised",
  "score":0.5362,
  "emoji":"😲"
}

Batch Request

curl -X POST https://mood-6421db30.fastapicloud.dev/analyze/batch \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @data.json

{
  "texts": [
    "I just got promoted — I am absolutely ecstatic!!!",
    "This is the third time it has crashed today. I am livid.",
    "I had no idea this was even possible. Completely stunned."
  ],
  "include_emoji": false,
  "include_reasons": true
}

---


[
  {
    "mood":"happy",
    "score":0.8103,
    "reasons":[
      "anchor: 'ecstatic'",
      "high punctuation intensity (3 exclamation marks)",
      "intensifier: 'absolutely'"
    ]
  },
   
  {
    "mood":"angry",
    "score":0.5714,
    "reasons":[
      "anchor: 'livid'"
    ]
  },
   
  {
    "mood":"surprised",
    "score":0.7285,
    "reasons":[
      "anchor: 'stunned'",
      "intensifier: 'completely'",
      "negator: 'no'"
    ]
  }
]

Pricing

All API features are available across every tier; pricing only controls usage limits (requests).

Free

$0 /month

50 requests
Single analyze
No rollover requests
Forum support

Micro

$1 /purchase

500 requests
Single/Batch analyze
Purchased requests stack*
Low-Priority email support**

Billed once

Basic

$9 /month

10,000 requests
Single/Batch analyze
Rollover requests
Medium-Priority email support**

Pro

$29 /month

50,000 requests
Single/Batch analyze
Rollover requests
High-Priority email support**

* Purchased requests stack every time you make a purchase and your requests do not expire.

** Support priority affects response time

mood_api // free tier access

Please enter a valid email address.

🌀

You're in.

Your API key will be sent to your email within the next 48 hours.

transmission received

Detect emotional tone in any text. Instantly.

Try it