Categories

Learn how to retrieve categories.

A category is a collection of grouped products within a catalog. They are used to organize products in your catalog to help shoppers locate products and navigate your store or site. This topic explains how to retrieve a category programmatically. You can also manage categories using Global Commerce.

Getting all categories and subcategories

The GET /v1/shoppers/me/categories request retrieves all categories and subcategories. See Categories query parameters for a description of the query parameters.

cURL

curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/categories' \
--header 'authorization: bearer ***\
...

200 OK response

Getting a category by identifier

The GET /v1/shoppers/me/categories/{categoryId} request retrieves a specific category and its subcategories by its category identifier (categoryId). See Categories query parameters for a description of the query parameters.

cURL

curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/categories/{categoryId}' \
--header 'authorization: bearer ***\
...

200 OK response

Getting all categories for a specific product

The GET /v1/shoppers/me/products/{productId}/categories request retrieves all categories and subcategories for a specific product. See Categories query parameters for a description of the query parameters.

cURL

curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/products/{productId}/categories' \
--header 'authorization: bearer ***\
...

200 OK response