younifyd
Menu

Search Categories

Search for categories within an organization.

POST/organizations/{organizationId}/category-search

Use it in a workflow

  1. Add a step and choose the Salesforce Commerce Cloud connector.
  2. Pick the Search Categories action (under Catalogs (Data API)).
  3. Fill in the fields below, then reference the result from later steps as {{searchCategories.response.data}}.

Request

Path parameters

organizationIdstringrequired

An identifier for the organization the request is being made by

Query parameters

levelsinteger (int32)

The level number.

Response

Returns 200 with an object. Read it in later steps with {{searchCategories.response.data.<field>}}.

hitsarray<object>

The sorted array of search hits. Can be empty.

catalogIdany

The ID of the catalog that contains it.

categoriesarray<object>

The array of subcategories for the category.

creationDatestring (date-time)

Returns the value of attribute 'creationDate'. It is read only.

descriptionobject

The localized description of the category.

idanyrequired

The ID of the category.

imagestring

The name of the category image. The URL to the image is computed.

lastModifiedstring (date-time)

Returns the value of attribute 'lastModified'. It is read only.

nameobject

The localized name of the category.

onlineboolean

The online status of the category determines if it is visible in the storefront. Defaults to false if not specified on creation.

pageDescriptionobject

The localized page description of the category.

pageKeywordsobject

The localized page keywords for the category.

pageTitleobject

The localized page title of the category.

parentCategoryIdstring

The ID of the parent category. Defaults to root if not specified on creation.

pathsarray<object>2 fields

The path record.

positionnumber (double)

The position of the category determines the display order in the storefront.

sortingRulesarray<object>6 fields

The category sorting rules.

thumbnailstring

The name of the category thumbnail. The URL to the thumbnail is computed.

json
{
  "hits": [
    {
      "id": "mens-clothing-outerwear",
      "catalogId": "apparel-catalog",
      "categories": [
        {}
      ],
      "creationDate": 253402214400,
      "description": {
        "en_US": "Mens Clothing Outerwear"
      },
      "image": "Summer Bomber Jacket",
      "lastModified": 253402214400,
      "name": {
        "en_US": "Mens Clothing Outerwear"
      },
      "online": true,
      "pageDescription": {
        "en_US": "Mens Outerwear Category"
      },
      "pageKeywords": {
        "en_US": "Outerwear"
      },
      "pageTitle": {
        "en_US": "Mens Clothing Outerwear"
      }
    }
  ]
}

Need more? See the Salesforce Commerce Cloud guide for connection setup and behaviour shared by every action.