Marketing channel health score (0-100) API

Transparent weighted rubric scoring a paid channel 0-100 from five normalized factors with documented weights (roas 0.30, ctr 0.15, conversionRate 0.20, ltvToCac 0.25, retention 0.10), returning a per-factor breakdown and an A-F grade. Answers 'how healthy is this marketing channel','what's dragging my channel score down'.

Price$0.01per request

MethodPOST

Route/v1/calc/mkt-channel-health-score

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcmarketingscorechannelhealthrubricgrademetrics

API URLhttps://x402.hexl.dev/v1/calc/mkt-channel-health-score

Integration docs

Example request

{
  "roas": 3.2,
  "ctr": 0.025,
  "conversionRate": 0.035,
  "ltvToCac": 3.5,
  "monthlyChurn": 0.04
}

Example response

{
  "score": 85.1,
  "rating": "A",
  "weights": {
    "roas": 0.3,
    "ctr": 0.15,
    "conversionRate": 0.2,
    "ltvToCac": 0.25,
    "retention": 0.1
  },
  "breakdown": [
    {
      "name": "roas",
      "weight": 0.3,
      "value": 0.8,
      "raw": 3.2,
      "contribution": 24
    },
    {
      "name": "ctr",
      "weight": 0.15,
      "value": 0.8333,
      "raw": 0.025,
      "contribution": 12.5
    },
    {
      "name": "conversionRate",
      "weight": 0.2,
      "value": 0.7,
      "raw": 0.035,
      "contribution": 14
    },
    {
      "name": "ltvToCac",
      "weight": 0.25,
      "value": 1,
      "raw": 3.5,
      "contribution": 25
    },
    {
      "name": "retention",
      "weight": 0.1,
      "value": 0.96,
      "raw": 0.04,
      "contribution": 9.6
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "roas",
    "ctr",
    "conversionRate",
    "ltvToCac",
    "monthlyChurn"
  ],
  "properties": {
    "roas": {
      "type": "number",
      "description": "return on ad spend ratio",
      "examples": [
        3.2
      ]
    },
    "ctr": {
      "type": "number",
      "description": "click-through rate, decimal in [0,1]",
      "examples": [
        0.025
      ]
    },
    "conversionRate": {
      "type": "number",
      "description": "decimal in [0,1]",
      "examples": [
        0.035
      ]
    },
    "ltvToCac": {
      "type": "number",
      "examples": [
        3.5
      ]
    },
    "monthlyChurn": {
      "type": "number",
      "description": "decimal in [0,1]",
      "examples": [
        0.04
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}