# Kroger Grocery API

> Kroger stores, categories, products, prices and variants (unverified)

- Vendor: `krogergroceryapi` · version 1.0 · category Food · tags kroger api, kroger grocery api, kroger product prices api, grocery data api, kroger store api, supermarket api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/krogergroceryapi
- This document: https://apiclay.com/docs/krogergroceryapi.md
- OpenAPI 3.1: https://apiclay.com/api/krogergroceryapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `krogergroceryapi`
- Updated: 2026-11-18

## About

## Kroger API

Kroger store and fulfillment preferences, the category taxonomy, category product search, product details by UPC with store prices, and product info (prices, stock, variant groups) for lists of UPCs, from the Kroger app and web APIs.

Data comes from **kroger.com** (https://www.kroger.com). Every route below calls the site's own endpoint directly and returns the upstream response unchanged.

Typical flow: `/stores` -&gt; `/menus` -&gt; `/categories` -&gt; `/products` -&gt; `/variants` (or `/product` by UPC)

Store ids are Kroger location ids (8 characters). `x-kroger-tenant` is the banner, e.g. `kroger` or `harristeeter`.

### Routes

#### POST `/stores` - Stores (store and fulfillment preferences)
Store details and the fulfillment objects (laf objects) the search routes need.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| x-kroger-tenant | header | string | yes | Banner, e.g. `kroger`. |
| x-facility-id | header | string | yes | Store location id. |
| x-modality | header | string | yes | `{"type":"PICKUP","locationId":""}`. |
| Cookie | header | string | no | `x-active-modality={"type":"PICKUP","locationId":"","source":"FALLBACK_ACTIVE_MODALITY_COOKIE"}`. |

Returns (fields the source code reads; not yet verified live):
- `data.modalityPreferences.storeDetails[]`: `locationId`, `address.address` (`postalCode`, `stateProvince`, `countryCode`), `county`, `location.lat` / `lng`
- `data.modalityPreferences.lafObject[]`: one per fulfillment type, with `modality.type` and `sources[]` (`storeId`, `facilityId`); send the PICKUP one (as a one-element JSON array) as `x-laf-object` below

#### GET `/menus` - Menus (taxonomy facets)
Top-level categories for the store.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| x-kroger-tenant | header | string | yes | Banner, e.g. `kroger`. |
| x-modality-type | header | string | yes | `PICKUP` or `DELIVERY`. |
| x-laf-object | header | string | yes | JSON array with the laf object from `/stores` (for DELIVERY, its `modality` set to the store's handoff address and location). |
| x-facility-id | header | string | no | Store location id. |
| x-modality | header | string | no | `{"type":"PICKUP","locationId":""}`. |
| x-modality-zip | header | string | no | Store zip. |
| x-modality-facility-id | header | string | no | Store location id. |
| x-modality-location | header | string | no | `\|` of the store. |
| Cookie | header | string | no | `x-active-modality={"type":"PICKUP","locationId":"","source":"PROFILE"}`. |

Returns (fields the source code reads; not yet verified live):
- `meta.productsSearch.facets.category[]`: `id`, `name`

#### GET `/categories` - Categories (subcategory facets)
Subcategories of a category. Same headers as `/menus`.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| filter.taxonomies | query | string | yes | Category id from `/menus`. |

Returns (fields the source code reads; not yet verified live):
- `meta.productsSearch.facets.category[0].children[]`: `id`, `name`

#### GET `/products` - Products (category search)
Products in a category. Same headers as `/menus`.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| filter.taxonomies | query | string | yes | Category id. |
| filter.fulfillmentMethods | query | string | yes | `PICKUP` or `DELIVERY`. |
| page.size | query | string | no | Up to `100`. |
| page.offset | query | string | no | Offset, up to `250`. |

Returns (fields the source code reads; not yet verified live):
- `data.productsSearch[]`: products with `upc` (send to `/variants` for prices and stock)
- `meta.productsSearch.facets.category[]`: category facets with `children`

#### GET `/product` - Product (details by UPC, web)
One product with store and national prices and availability.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| filter.gtin13s | query | string | yes | 13-digit UPC. |
| X-Facility-Id | header | string | yes | Store location id. |
| x-laf-object | header | string | yes | JSON array of laf objects (as returned by `/stores`). |
| x-modality | header | string | yes | `{"type":"PICKUP","locationId":""}`. |

Returns (fields the source code reads; not yet verified live):
- `data.products[0].price.storePrices` (`regular.price`, `promo.price`) and `price.nationalPrices`
- `data.products[0].sourceLocations[]`: `id`, `modalityAvailabilities[]` (`modalityType`, `availability`)
- `data.products[0].inventory.locations[]`

#### (not published) `/variants` - Variants (product info by UPC list)
Product info, prices, stock and variant groups for a list of UPCs. Same headers as `/menus`.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| (body) | body (JSON) | array | yes | JSON array of 13-digit UPCs, e.g. `[""]`. |

Returns (fields the source code reads; not yet verified live):
- products with `upc`, description, price, locations and `variantGroups[0].variantItems[].gtin13` (post those UPCs again to get the variants)

### Caveats

- These routes were written from MealMe's source code and have not been tested live yet (the site blocks plain requests from the test machine).
- The source site uses bot protection (Akamai); calls may be blocked until that is handled.
- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- Not affiliated with kroger.com or The Kroger Co..

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /stores — Stores (store and fulfillment preferences)
- Gateway: `POST https://api.apiclay.com/v1/api/krogergroceryapi/stores`
- Public headers: `x-kroger-tenant` (required), `x-facility-id` (required), `x-modality` (required), `Cookie`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /menus — Menus (taxonomy facets)
- Gateway: `GET https://api.apiclay.com/v1/api/krogergroceryapi/menus`
- Public headers: `x-kroger-tenant` (required), `x-modality-type` (required), `x-laf-object` (required), `x-facility-id`, `x-modality`, `x-modality-zip`, `x-modality-facility-id`, `x-modality-location`, `Cookie`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories (subcategory facets)
- Gateway: `GET https://api.apiclay.com/v1/api/krogergroceryapi/categories`
- Public headers: `x-kroger-tenant` (required), `x-modality-type` (required), `x-laf-object` (required), `x-facility-id`, `x-modality`, `x-modality-zip`, `x-modality-facility-id`, `x-modality-location`, `Cookie`
- Public query params: `filter.taxonomies` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /products — Products (category search)
- Gateway: `GET https://api.apiclay.com/v1/api/krogergroceryapi/products`
- Public headers: `x-kroger-tenant` (required), `x-modality-type` (required), `x-laf-object` (required), `x-facility-id`, `x-modality`, `x-modality-zip`, `x-modality-facility-id`, `x-modality-location`, `Cookie`
- Public query params: `filter.fulfillmentMethods` (string, required), `filter.taxonomies` (string, required), `page.size` (string), `page.offset` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /product — Product (details by UPC, web)
- Gateway: `GET https://api.apiclay.com/v1/api/krogergroceryapi/product`
- Public headers: `X-Facility-Id` (required), `x-laf-object` (required), `x-modality` (required)
- Public query params: `filter.gtin13s` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/krogergroceryapi/stores" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "x-kroger-tenant: <X_KROGER_TENANT>" \
  -H "x-facility-id: <X_FACILITY_ID>" \
  -H "x-modality: <X_MODALITY>"
```

Index of every published API: https://apiclay.com/llms.txt
