Percentile rank / percentile value API

Compute the percentile rank of a value within a dataset (mid-rank: (below+0.5·equal)/n·100), or invert a percentile to its value via linear interpolation (R-7 / Excel PERCENTILE.INC). Auditable: returns counts below/equal. Answers 'what percentile is 35 in this data','the 90th percentile value','rank of this score'.

Price$0.01per request

MethodPOST

Route/v1/calc/stat-percentile-rank

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcstatisticspercentilerankquantiledistributioninterpolationranking

API URLhttps://x402.hexl.dev/v1/calc/stat-percentile-rank

Integration docs

Example request

{
  "data": [
    10,
    20,
    30,
    40,
    50
  ],
  "value": 35
}

Example response

{
  "mode": "value->percentile",
  "value": 35,
  "percentileRank": 60,
  "n": 5,
  "countBelow": 3,
  "countEqual": 0,
  "rating": "above median",
  "interpretation": "35 is at the 60th percentile of 5 values."
}

Input schema

{
  "type": "object",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "examples": [
        [
          10,
          20,
          30,
          40,
          50
        ]
      ]
    },
    "value": {
      "type": "number",
      "description": "value to rank",
      "examples": [
        35
      ]
    },
    "percentile": {
      "type": "number",
      "description": "or supply a percentile (0-100) to get its value"
    }
  }
}

Output schema

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