Calculators

ROAS (return on ad spend) calculator API

Compute ROAS = revenue / adSpend with rating buckets, and (given grossMargin) the margin-aware break-even ROAS = 1/grossMargin plus gross profit. Answers 'what's my ROAS','am I profitable at this margin','what ROAS do I need to break even'.

Price$0.01per request

MethodPOST

Route/v1/calc/mkt-roas

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcmarketingroasadvertisingrevenueprofitabilityroimetrics

API URLhttps://x402.hexl.dev/v1/calc/mkt-roas

Integration docs

Example request

{
  "revenue": 24000,
  "adSpend": 6000,
  "grossMargin": 0.5
}

Example response

{
  "formula": "ROAS = revenue / adSpend",
  "revenue": 24000,
  "adSpend": 6000,
  "roas": 4,
  "roasPercent": 400,
  "rating": "excellent",
  "grossMargin": 0.5,
  "breakEvenRoas": 2,
  "profitable": true,
  "grossProfit": 6000
}

Input schema

{
  "type": "object",
  "required": [
    "revenue",
    "adSpend"
  ],
  "properties": {
    "revenue": {
      "type": "number",
      "description": "revenue attributed to the ads",
      "examples": [
        24000
      ]
    },
    "adSpend": {
      "type": "number",
      "examples": [
        6000
      ]
    },
    "grossMargin": {
      "type": "number",
      "description": "gross margin as a decimal in [0,1]",
      "examples": [
        0.5
      ]
    }
  }
}

Output schema

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