Store-health composite score (0-100) API

Composite e-commerce store-health score (0-100, A-F grade) over 5 transparent weighted factors — conversion 0.25, repeat-purchase 0.2, gross margin 0.2, cart retention 0.2, return quality 0.15 — with a per-factor contribution breakdown so the score is auditable. Answers 'how healthy is my store','score my e-commerce funnel'.

Price$0.01per request

MethodPOST

Route/v1/calc/ecom-store-health-score

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

ecomscorestore-healthrubricconversionretentionecommercecalc

API URLhttps://x402.hexl.dev/v1/calc/ecom-store-health-score

Integration docs

Example request

{
  "conversionRate": 0.03,
  "repeatPurchaseRate": 0.4,
  "grossMargin": 0.5,
  "cartAbandonmentRate": 0.6,
  "returnRate": 0.1
}

Example response

{
  "rubric": "weighted sum of 5 normalized factors × 100. Weights: conversion 0.25, repeat 0.2, margin 0.2, cartRetention 0.2, returnQuality 0.15",
  "score": 62.5,
  "grade": "C",
  "rating": "fair",
  "breakdown": [
    {
      "factor": "conversionRate",
      "weight": 0.25,
      "normalized": 0.6,
      "contribution": 15
    },
    {
      "factor": "repeatPurchaseRate",
      "weight": 0.2,
      "normalized": 0.8,
      "contribution": 16
    },
    {
      "factor": "grossMargin",
      "weight": 0.2,
      "normalized": 0.5,
      "contribution": 10
    },
    {
      "factor": "cartRetention",
      "weight": 0.2,
      "normalized": 0.4,
      "contribution": 8
    },
    {
      "factor": "returnQuality",
      "weight": 0.15,
      "normalized": 0.9,
      "contribution": 13.5
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "conversionRate",
    "repeatPurchaseRate",
    "grossMargin",
    "cartAbandonmentRate",
    "returnRate"
  ],
  "properties": {
    "conversionRate": {
      "type": "number",
      "description": "Decimal 0-1",
      "examples": [
        0.03
      ]
    },
    "repeatPurchaseRate": {
      "type": "number",
      "description": "Decimal 0-1",
      "examples": [
        0.4
      ]
    },
    "grossMargin": {
      "type": "number",
      "description": "Decimal 0-1",
      "examples": [
        0.5
      ]
    },
    "cartAbandonmentRate": {
      "type": "number",
      "description": "Decimal 0-1",
      "examples": [
        0.6
      ]
    },
    "returnRate": {
      "type": "number",
      "description": "Decimal 0-1",
      "examples": [
        0.1
      ]
    }
  }
}

Output schema

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