Kroger

Kroger Search API

Search Kroger products by keyword and get structured rows as JSON: regular and promo prices in cents, N-for-X deals, unit price, UPC, stock status, SNAP eligibility, dietary tags, rating and category. Works across all Kroger-family banners: Kroger, Ralphs, Fred Meyer, Harris Teeter, King Soopers, Fry's and more. Costs 2 credits per request.

POST/api/v1/kroger/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Keywords to search for, 1-200 characters.

Example: organic milk

pageintegerdefault:1

Results page, 1-based.

Example: 2

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

results = client.kroger.search("organic milk")

for item in results["data"]["results"]:
    promo = f" -> {item['promo_price_cents']}c" if item["promo_price_cents"] else ""
    print(item["name"], f"{item['price_cents']}c{promo}", item["dietary"])

Response

"query": "organic milk",

"total_results": 134,

"page": 1,

"response_time": 2673

}