/api/segment_hierarchy_chart

Header

X-Customer-Api-Id: <uuid> 
X-Secret:          <secret> 
Content-Type:      application/json 

Request Body Schema

dendrogram: { 
  linkage_matrix: 2-D array of [child1, child2, distance, sample_count], 
  leaf_labels:    array<string>, 
  cluster_legend: array<object> (optional) 
} 

Example Request Body

{
  "dendrogram": {
    "linkage_matrix": [
      [1.0,27.0,5.5900115966796875,2.0],
      [16.0,34.0,10.246950765959598,2.0],
      [10.0,38.0,14.5,2.0],
      [18.0,33.0,14.684114387072421,2.0],
      [2.0,24.0,14.933482805184708,2.0],
      [14.0,20.0,15.033296378372908,2.0],
      [8.0,23.0,15.033296378372908,2.0],
      [9.0,22.0,16.41102378466232,2.0],
      [12.0,40.0,19.554342797373597,3.0],
      [30.0,41.0,23.67840084690405,3.0],
      [19.0,36.0,24.720185838561353,2.0],
      [5.0,31.0,29.71684244831212,2.0],
      [3.0,45.0,31.75951301054011,3.0],
      [39.0,47.0,37.04603277151646,3.0],
      [46.0,49.0,53.204636389447614,5.0],
      [7.0,43.0,60.837535989873956,3.0],
      [26.0,48.0,75.42189702647553,4.0],
      [4.0,35.0,83.95602895187841,2.0],
      [50.0,51.0,102.69139093644127,4.0],
      [15.0,53.0,135.75478433757996,4.0],
      [54.0,56.0,139.4687935795597,9.0],
      [21.0,57.0,147.95607449395212,3.0],
      [42.0,58.0,193.4435440607144,6.0],
      [25.0,29.0,215.00232556881798,2.0],
      [44.0,55.0,220.82693991432996,5.0],
      [13.0,37.0,221.00452484055614,2.0],
      [6.0,11.0,235.00212764994276,2.0],
      [52.0,60.0,256.36800922508723,12.0],
      [28.0,61.0,336.40545943552,4.0],
      [0.0,17.0,401.8550746056813,2.0],
      [32.0,66.0,522.3946688588159,3.0],
      [62.0,64.0,537.5921954390619,11.0],
      [63.0,65.0,647.7163731140352,4.0],
      [59.0,68.0,743.4835774228395,8.0],
      [70.0,72.0,1528.9174504219059,7.0],
      [67.0,71.0,1623.9774150881199,23.0],
      [73.0,75.0,2865.3048816814076,31.0],
      [69.0,74.0,3076.681261272462,9.0],
      [76.0,77.0,8866.563988339083,40.0]
    ],
    "leaf_labels": ["C001","C002",…,"C040"],
    "cluster_legend": [
      {"cluster_id":0,"n_customers":9,"avg_spend":2964.99,"avg_frequency":24.44,"top_categories":"laptop, mouse, air-fryer"},
      {"cluster_id":1,"n_customers":31,"avg_spend":591.11,"avg_frequency":8.81,"top_categories":"wine, cheese, diapers"}
    ]
  }
}

Example Response Body

{
  "nodes": [
    {"id":0,"label":"C001","is_leaf":true},
    …,
    {"id":39,"label":"C040","is_leaf":true},
    {"id":40,"distance":5.59,"size":2,"is_leaf":false},
    …,
    {"id":78,"distance":8866.56,"size":40,"is_leaf":false}
  ],
  "links": [
    {"source":40,"target":1,"distance":5.59},
    {"source":40,"target":27,"distance":5.59},
    …,
    {"source":78,"target":76,"distance":8866.56},
    {"source":78,"target":77,"distance":8866.56}
  ],
  "cluster_legend": [
    {"cluster_id":0,"n_customers":9,"avg_spend":2964.99,"avg_frequency":24.44,"top_categories":"laptop, mouse, air-fryer"},
    {"cluster_id":1,"n_customers":31,"avg_spend":591.11,"avg_frequency":8.81,"top_categories":"wine, cheese, diapers"}
  ]
}

Description

Transforms a raw dendrogram into front-end–ready `nodes`, `links`, and `cluster_legend` arrays—no extra parsing needed in D3, Plotly, ECharts, or React.

Business Usage

Ideal for interactive cluster explorers: load `nodes` & `links` into your force-graph or radial dendrogram; use `cluster_legend` for tooltips or side panels.

← Back to all routes