---
title: "Get Kroger search-box suggestions"
method: GET
path: "/kroger/suggest"
tags: ["Kroger"]
---

# Get Kroger search-box suggestions

`GET /kroger/suggest`

## Request

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

Returns Kroger's own search-box suggestions for a (possibly empty) query, sourced directly from Kroger's public suggestions API rather than the rendered search page. An empty query returns Kroger's default "trending" shopping shortcuts instead of an error. location_id scopes results to one Kroger store and defaults to a confirmed-working store id when omitted.

## Query parameters

- `query` string
- `location_id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- KrogerSuggestResponseDoc
  - `code` integer
  - `data` KrogerSuggestResponse
    - `location_id` string
    - `query` string
    - `spelling_correction` string: SpellingCorrection is Kroger's own suggested respelling of Query, set only when Query returned zero suggestions and Kroger judged it a likely typo (confirmed live: "Marble cake" -> "maple cake" with an empty Suggestions list).
    - `suggestions` KrogerSuggestion[]
      - `type` string
      - `value` 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)