Kroger

Search Kroger products

Searches Kroger products by keyword and returns product cards (price, unit price, brand, size, stock level) plus the facet groups Kroger offers for the query (brands, nutrition, savings, price range and more). It supports real pagination, and the source field reports which path answered. Facet filters and sort apply to the primary path only: when any of them is set, a failure of that path returns an error rather than silently falling back to unfiltered results.

get/kroger/search

Request

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

Query parameters

querystring required

Search keyword

pageinteger

One-based result page

sort'relevance' | 'name_asc' | 'popularity_desc'

Result order. One of: relevance, name_asc, popularity_desc

brandsstring

Comma-separated brand names to filter by, taken verbatim from a previous response's facets

nutritionstring

Comma-separated nutrition/dietary facet values

flavorstring

Comma-separated flavor facet values

scentstring

Comma-separated scent facet values

savingsstring

Comma-separated savings facet values

more_optionsstring

Comma-separated more-options facet values

price_minnumber

Lower bound of the price filter; defaults to 0

price_maxnumber

Upper bound of the price filter; required to filter on price

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.