---
title: "Search by store facets"
method: GET
path: "/api/catalog_system/pub/facets/search/{term}"
tags: ["Facets"]
---

# Search by store facets

`GET /api/catalog_system/pub/facets/search/{term}`

Retrieves products by store facets. The result order is descending, from the highest product ID to the lowest.

## Path parameters

- `term` string, required

## Query parameters

- `map` string, required

## Headers

- `Accept` string, required
- `Content-Type` string, required

## Response `200`

OK

- object
  - `Departments` object[], required — Array of general information about the categories.
    - `Quantity` integer, required — Quantity of facets.
    - `Position` integer, nullable, required — Position of the facets.
    - `Name` string, required — Category name.
    - `Link` string, required — Link of the facet.
    - `LinkEncoded` string, required — Encoded link of the facet.
    - `Map` string, required — Mapping of the facet.
    - `Value` string, required — Value of the facet.
  - `Brands` object[], required — Array of general information about the brands.
    - `Quantity` integer, required — Quantity of facets.
    - `Position` integer, nullable, required — Position of the facet.
    - `Name` string, required — Brand name.
    - `Link` string, required — Link of the facet.
    - `LinkEncoded` string, required — Enconded link of the facet.
    - `Map` string, required — Mapping of the facet.
    - `Value` string, required — Value of the facet.
  - `SpecificationFilters` object, required — Object with general information of specifications.
  - `CategoriesTrees` object[], required — Array of the category tree.
    - `Id` integer, required — Category ID.
    - `Quantity` integer, required — Quantity of the facets.
    - `Position` integer, nullable, required — Position of the facet.
    - `Name` string, required — Category name.
    - `Link` string, required — Link of the facet.
    - `LinkEncoded` string, required — Encoded link of the facet.
    - `Map` string, required — Mapping of the facet.
    - `Value` string, required — Value of the facet.
    - `Children` object[], required — Category children.
      - `Id` integer, required — Category ID.
      - `Quantity` integer, required — Quantity of the facets.
      - `Position` integer, nullable, required — Position of the facet.
      - `Name` string, required — Category name.
      - `Link` string, required — Link of the facet.
      - `LinkEncoded` string, required — Encoded link of the facet.
      - `Map` string, required — Mapping of the facet.
      - `Value` string, required — Value of the facet.
      - `Children` unknown[], required — Category children.
        - unknown
  - `PriceRanges` unknown[], required — Array with general information of the price ranges.
    - unknown
  - `Summary` object, required — Summary of the facets.
    - `Departments` object, required — Departments' quantity of displayed and total items.
      - `DisplayedItems` integer, required — Quantity of displayed items.
      - `TotalItems` integer, required — Quantity of total items.
    - `CategoriesTrees` object, required — Category tree's quantity of displayed and total items.
      - `DisplayedItems` integer, required — Quantity of displayed items.
      - `TotalItems` integer, required — Quantity of total items.
    - `Brands` object, required — Brands' quantity of displayed and total items.
      - `DisplayedItems` integer, required — Quantity of displayed items.
      - `TotalItems` integer, required — Quantity of total items.
    - `PriceRanges` object, required — Price ranges' quantity of displayed and total items.
      - `DisplayedItems` integer, required — Quantity of displayed items.
      - `TotalItems` integer, required — Quantity of total items.
    - `SpecificationFilters` object, required — Specification filters' quantity of displayed and total items.

---

[API](https://skmtc.dev/vtex/apis/legacy-search-api.md) · [All operations](https://skmtc.dev/vtex/apis/legacy-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vtex/legacy-search-api/revisions/f6572c6b745b/schema)