Fetch available facets like attributes, variant names, and price ranges. Facet keys is a comma separated string. Valid keys are: "attributes", "attributes[template_key1|template_key2]", "variant_names", "price", "tags", "collections", "categories", "brands", "series", "variant_with_attributes[template_key1|template_key2]". Product filters are optional. Deprecated. Use https://graphql.enad.io instead.

API ownership

• API family: Shopper API
• Best for: Public storefront catalog reads and shopper-facing product discovery.
• Prefer Search API for: New product discovery, facets, autocomplete, and other search-heavy storefront flows.
• Do not use from: Trusted admin integrations that create, update, or delete merchant-owned data.
• Guide route: /apis/shopper/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: GET
• Path: /api/v1/omni/:app_id/:store_group/:market/:locale/facets/\{facet_keys\}
• Summary: Fetch facets
• Description: Fetch available facets like attributes, variant names, and price ranges. Facet keys is a comma separated string. Valid keys are: "attributes", "attributes[template_key1|template_key2]", "variant_names", "price", "tags", "collections", "categories", "brands", "series", "variant_with_attributes[template_key1|template_key2]". Product filters are optional. Deprecated. Use https://graphql.enad.io instead.
• OpenAPI contract: shopper-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "data": {
    "attributes": {},
    "brands": [
      {
        "id": "string",
        "name": "string",
        "slug": "string"
      }
    ],
    "categories": [
      {
        "attributes": {},
        "cover_url": "string",
        "full_path_name": [],
        "full_uri_translations": {},
        "id": "string",
        "name": "string",
        "parent_id": "string",
        "redirects": {},
        "slug_translations": {},
        "sort_order": 0,
        "status": "string",
        "sub_categories": [],
        "uri": "string"
      }
    ],
    "collections": [
      {
        "children": [],
        "id": "string",
        "parent_id": "string",
        "title": "string",
        "uri": "string"
      }
    ],
    "price_range": {
      "max": 0,
      "min": 0
    },
    "series": [
      {
        "id": "string",
        "name": "string",
        "slug": "string"
      }
    ],
    "tags": [
      {
        "id": "string",
        "key": "string",
        "name": "string"
      }
    ],
    "variant_names": [
      "string"
    ],
    "variant_with_attributes": [
      {
        "attributes": {},
        "variant_name": "string",
        "variant_number": "string"
      }
    ]
  }
}

{
  "message": "string"
}

{
  "message": "string"
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: Shopper API
• Method: GET
• Path: /api/v1/omni/:app_id/:store_group/:market/:locale/facets/\{facet_keys\}
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Facets
• OpenAPI summary: Fetch facets