Sign in

v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-1915251.8 MB
Facets

Get category facets

Retrieves the names and IDs of the categories facets.

⚠️ This endpoint returns a maximum of 50 items per response, so the difference between _from and _to should not exceed this number. The result order is descending, from the highest product ID to the lowest.

Response body example:

[
	[
    {
      "Name":"Tamanho Global",
      "Id":45
		},
		{
      "Name":"Percentuals",
      "Id":25
		}
	]
]
get/api/catalog_system/pub/facets/category/{categoryId}

Path parameters

categoryIdstring required
Example:1

Category unique number identifier.

Query parameters

_fromstring
Example:1

Starter page range. These parameters allow the API to be paginated. Take into account that the initial and final pages cannot have a separation superior to 50 pages. Thus, it will be displayed 50 items per page.

_tostring
Example:50

Finisher page range. These parameters allow the API to be paginated. Take into account that the initial and final pages cannot have a separation superior to 50 pages. Thus, it will be displayed 50 items per page.

Headers

Acceptstring required
Example:application/json

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.

Content-Typestring required
Example:application/json

Describes the type of the content being sent.

Response

OK

Namestring required

Category's facet name.

Idinteger required

Category's facet ID.

Example response

[
  {
    "Name": "Tamanho Global",
    "Id": 45
  }
]