Docs menu

Kroger API endpoint

Kroger suggest API

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.

GETapiKey3 credits/requestKrogerkroger.suggestResponseDoc/kroger/suggest

Endpoint facts

Method: GET
API path: /kroger/suggest
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Kroger
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/kroger.suggestResponseDoc

Kroger API Try Kroger suggest API in Playground Kroger API documentation

How this endpoint behaves

Query parameters:

query (optional) — partial search text. Omit it to get Kroger's own default "trending" shopping shortcuts (a real response shape, not an error case) instead of term suggestions.
location_id (optional) — a Kroger store/location id that scopes suggestions. Defaults to a confirmed-working store id when omitted.

Notable response behavior:

Each item in suggestions has a type — SUGGESTION for a term suggestion, TRENDING for a default shopping shortcut shown when query is omitted — passed through from Kroger's own API rather than validated against a fixed list, so a future third type still surfaces.
spelling_correction is set only when query returned zero suggestions and Kroger judged it a likely typo (e.g. Marble cake → maple cake); it is omitted otherwise.
A genuinely empty suggestions list (with or without spelling_correction) is a normal, successful response — not an error.

Live monitoring

Monitored request: GET /kroger/suggest?query=rin
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.92 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /kroger/suggest?query=rin
Items in suggestions: 5
Fields filled in every checked item: 2

Field	Filled in, of 5 checked	Values in the sample
type	5	SUGGESTION in all 5
value	5	“onion ring” and 4 other values

Request parameters

Parameter	Type	Required	Description	Example
query	string	No	Partial search text; omit for trending default suggestions	rin
location_id	string	No	Kroger store/location id	03500917
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/kroger/suggest?query=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "rin",
    "location_id": "03500917",
    "suggestions": [
      {
        "type": "SUGGESTION",
        "value": "onion ring"
      },
      {
        "type": "SUGGESTION",
        "value": "pork rind"
      },
      {
        "type": "SUGGESTION",
        "value": "white castle chicken ring"
      },
      {
        "type": "SUGGESTION",
        "value": "rinse aid"
      },
      {
        "type": "SUGGESTION",
        "value": "frozen onion ring"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/kroger.suggestResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	kroger.SuggestResponse	No
data.location_id	string	No
data.query	string	No
data.spelling_correction	string	No		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).
data.suggestions	array	No
data.suggestions[].type	string	No
data.suggestions[].value	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/kroger/suggest?query=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Kroger endpoint docs Kroger API Kroger categories API documentation Kroger category API documentation Kroger coupons API documentation Kroger product API documentation Kroger product reviews API documentation Kroger products API documentation

Open in Playground Back to group

Docs menu

Kroger API endpoint

Kroger suggest API

GETapiKey3 credits/requestKrogerkroger.suggestResponseDoc/kroger/suggest

Endpoint facts

Method: GET
API path: /kroger/suggest
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Kroger
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/kroger.suggestResponseDoc

Kroger API Try Kroger suggest API in Playground Kroger API documentation

How this endpoint behaves

Query parameters:

query (optional) — partial search text. Omit it to get Kroger's own default "trending" shopping shortcuts (a real response shape, not an error case) instead of term suggestions.
location_id (optional) — a Kroger store/location id that scopes suggestions. Defaults to a confirmed-working store id when omitted.

Notable response behavior:

Each item in suggestions has a type — SUGGESTION for a term suggestion, TRENDING for a default shopping shortcut shown when query is omitted — passed through from Kroger's own API rather than validated against a fixed list, so a future third type still surfaces.
spelling_correction is set only when query returned zero suggestions and Kroger judged it a likely typo (e.g. Marble cake → maple cake); it is omitted otherwise.
A genuinely empty suggestions list (with or without spelling_correction) is a normal, successful response — not an error.

Live monitoring

Monitored request: GET /kroger/suggest?query=rin
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.92 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /kroger/suggest?query=rin
Items in suggestions: 5
Fields filled in every checked item: 2

Field	Filled in, of 5 checked	Values in the sample
type	5	SUGGESTION in all 5
value	5	“onion ring” and 4 other values

Request parameters

Parameter	Type	Required	Description	Example
query	string	No	Partial search text; omit for trending default suggestions	rin
location_id	string	No	Kroger store/location id	03500917
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/kroger/suggest?query=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "rin",
    "location_id": "03500917",
    "suggestions": [
      {
        "type": "SUGGESTION",
        "value": "onion ring"
      },
      {
        "type": "SUGGESTION",
        "value": "pork rind"
      },
      {
        "type": "SUGGESTION",
        "value": "white castle chicken ring"
      },
      {
        "type": "SUGGESTION",
        "value": "rinse aid"
      },
      {
        "type": "SUGGESTION",
        "value": "frozen onion ring"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/kroger.suggestResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	kroger.SuggestResponse	No
data.location_id	string	No
data.query	string	No
data.spelling_correction	string	No		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).
data.suggestions	array	No
data.suggestions[].type	string	No
data.suggestions[].value	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/kroger/suggest?query=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Kroger suggest API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Kroger suggest API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related