Category

Category information and navigation

Retrieve category detail page

get

Returns category information along with subcategory hierarchy for navigation.

Response Behavior:

1. Landing Page Mode (shallow categories) When the category depth is at or below the configured maximum (Source: Dynamic/Real-time Configuration):

• Returns category information with subcategories

• Includes up to 2 levels of nested subcategories

• Suitable for category landing pages

2. Listing Mode (deep categories) When the category depth exceeds the maximum:

• Returns product listing (faceted search results)

• Includes category metadata alongside product results

• Uses category-specific sort options when configured

Subcategory Structure:

• First level: Direct children of the requested category

• Second level: Children of direct children

• Each subcategory includes navigation URLs

Path parameters

category_idintegerRequired

Unique identifier of the category to retrieve.

Example: 150

Responses

200

Category detail retrieved successfully

application/json

404

Category not found.

Occurs when:

• No category exists with the specified ID
• Category depth is 1 or less (root categories are not accessible)

get

/category/{category_id}/

HTTPcURLJavaScriptPython

GET /category/{category_id}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "pk": 150,
  "name": "Running Shoes",
  "menuitemmodel": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "absolute_url": "/categories/running-shoes/",
  "attributes": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "depth": 3,
  "path": "0001000200030004",
  "sort_option": 5,
  "sub_categories": [
    {
      "pk": 150,
      "name": "Running Shoes",
      "menuitemmodel": null,
      "absolute_url": "/categories/running-shoes/",
      "attributes": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "depth": 3,
      "path": "text",
      "children": [
        {
          "pk": 150,
          "name": "Running Shoes",
          "menuitemmodel": null,
          "absolute_url": "/categories/running-shoes/",
          "attributes": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "uuid": "123e4567-e89b-12d3-a456-426614174000",
          "depth": 3,
          "path": "text"
        }
      ]
    }
  ]
}

Retrieve categories for a product

get

Returns all category nodes associated with a specific product.

Response Order: Categories are returned ordered by their path, ensuring hierarchical consistency for breadcrumb display.

Path parameters

product_idintegerRequired

Unique identifier of the product.

Example: 12345

Responses

200

Product categories retrieved successfully

application/json

get

/products/{product_id}/category_nodes/

HTTPcURLJavaScriptPython

GET /products/{product_id}/category_nodes/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

200

Product categories retrieved successfully

[
  {
    "pk": 150,
    "name": "Running Shoes",
    "menuitemmodel": null,
    "absolute_url": "/categories/running-shoes/",
    "attributes": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "depth": 3,
    "path": "text"
  }
]