Facets — GET /v1/facets — Commerce Census

Facets

The filterable axes for a category and their real value distributions — how you build a filter UI that matches what actually exists rather than what you guessed.

GET /v1/facets

Request

Name	Type	Notes
category	string	Taxonomy node.

Request & response

GET /v1/facets?category=apparel.outerwear

→ 200
{ "facets": [
   { "key": "apparel.size", "label": "Size", "type": "ordinal",
     "values": [ { "v": "S", "products": 812 }, { "v": "M", "products": 851 },
                 { "v": "L", "products": 840 }, { "v": "XL", "products": 733 } ] },
   { "key": "apparel.colour", "label": "Colour", "type": "categorical",
     "values": [ { "v": "black", "products": 1104 }, { "v": "navy", "products": 402 } ] },
   { "key": "general.price", "label": "Price", "type": "range",
     "min_minor": 1999, "max_minor": 89900, "p50_minor": 12900 } ] }