---
title: "Get Kroger's product-browse category taxonomy"
method: GET
path: "/kroger/categories"
tags: ["Kroger"]
---

# Get Kroger's product-browse category taxonomy

`GET /kroger/categories`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/kroger/categories`
- Auth: API key in header `x-api-key`

Returns Kroger's full product-browse category taxonomy: every slug/category_id pair kroger-search and kroger-category accept, each with its department and full breadcrumb. This is how to discover valid slug/category_id values -- previously the only way was to already have one from a search response's facet group. Sourced from Kroger's own site navigation menu; covers every category a shopper can browse to from Kroger's site menu (321 at time of writing across 7 departments). Takes no parameters.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- KrogerCategoriesResponseDoc
  - `code` integer
  - `data` KrogerCategoriesResponse
    - `categories` KrogerCategoryTaxon[]
      - `breadcrumb` string[]: Breadcrumb is the full department > aisle > category path, deduplicated where Kroger's own menu repeats a level's name at the next level down.
      - `category_id` string
      - `department` string: Department is the top-level department this category rolls up under (Breadcrumb[0]), included as a convenience field for grouping/filtering without parsing Breadcrumb.
      - `name` string
      - `slug` string
      - `url` string: URL is the canonical kroger.com category-browse page URL.
    - `count` integer
    - `departments` string[]: Departments lists the top-level departments that contributed at least one category below, in Kroger's own menu order.
    - `source_url` string
  - `msg` string

## Other responses

- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)