API Documentation

The VibeScore API — emotional intelligence as a service.

Quick Start

curl -X POST https://adverblabs.com/api/v1/score \
  -H "Authorization: Bearer vibe_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text": "Our mission is to democratize creativity"}'

Authentication

Include your API key in the Authorization header:

Authorization: Bearer vibe_your_key_here

Generate your API key via POST /api/v1/keys with your email. The key is shown once — save it securely.

Endpoints

POST/api/v1/scoreAuth required

Score a single piece of text against 8 emotion dimensions using 4 AI models.

Request body
{ "text": "Your content here", "type": "text" }
Response
{
  "scores": {
    "claude": { "joy": 0.72, "trust": 0.85, ... },
    "gpt4o": { "joy": 0.68, "trust": 0.82, ... },
    "gemini": { "joy": 0.75, "trust": 0.80, ... },
    "grok": { "joy": 0.70, "trust": 0.88, ... }
  },
  "divergence": { "joy": 0.0008, "trust": 0.0011, ... },
  "consensus": 0.87,
  "dominant_emotion": "trust",
  "signal_quality": "clear",
  "measurement_id": "uuid",
  "usage": { "remaining": 95, "limit": 100, "resets_at": "..." }
}
POST/api/v1/batchAuth required

Score up to 10 texts in a single request. Each text counts as 1 against your rate limit.

Request body
{ "texts": ["Text 1", "Text 2", ...], "type": "text" }
Response
{
  "results": [
    { "vibeResponse": { ... }, "measurement_id": "uuid" },
    { "vibeResponse": { ... }, "measurement_id": "uuid" }
  ],
  "summary": { "total": 2, "succeeded": 2, "failed": 0 },
  "usage": { "remaining": 93, "limit": 100, "resets_at": "..." }
}
GET/api/v1/health

Check API status. No authentication required.

Response
{
  "status": "operational",
  "version": "1.0.0",
  "models": ["claude", "gpt4o", "gemini", "grok"],
  "timestamp": "2026-03-07T12:00:00Z"
}

Input Types

The type field is optional and defaults to "text".

TypeUse case
textGeneral text, marketing copy, brand statements
transcriptMeeting transcripts, podcasts, interviews
socialSocial media posts, tweets, captions
content_auditMulti-piece content comparison
image_descImage descriptions or alt text

Rate Limits

Free

100 req/hr

$0

Pro

1,000 req/hr

Coming soon

Enterprise

Unlimited

Contact us

The Eight Emotions

Proprietary 8-dimension emotional measurement. Each score is 0.0 to 1.0.

JoyTrustFearSurpriseSadnessDisgustAngerAnticipation