Eureka: Category Collection

The Category Collection type of the Eureka’s Category Merchandising API allows the retrieval of all products belonging to a specific category in the product catalog, helping to narrow down results based on product type. For example, you can retrieve products under the "Footwear" category to get all shoes.

Structures

Flat Structure

Some catalogs use a non-hierarchical or flat category structure where categories are not nested (e.g., Shoes, Footwear instead of Women > Shoes > Sneakers). In this case, you can retrieve products within specific categories, such as Shoes.

Multiple Flat Category Retrieval

Only products belonging to both categories are returned when multiple singular categories are used in a flat category search. These categories are connected using an "AND" condition, meaning that a product must be classified under both to be included. For example, searching for Shoes and Footwear will return only products categorized as both Shoes and Footwear.

The cf parameter should be formatted the same way as in hierarchical structures, such as shoes or shoes~footwear

Hierarchical Structure

Some catalogs use a hierarchical category structure, where categories follow a parent-child relationship (e.g., Women > Shoes > Sneakers). In this case, searches should use the whole structure to ensure accurate results. For example, to retrieve products under Women > Shoes, use Women~Shoes.

Request Parameters