Kroger

Kroger Category API

A Kroger, QFC or Fred Meyer category listing by /pl/ URL or taxonomy id: the category (id, name, url) and up to 24 products in the search row shape with UPC, price, promo price, unit price, stock, SNAP eligibility, dietary info and rating, plus total and the store that priced them (a store the site chooses). Prices are integer cents. Only the first page is available. Costs 1 credit per request.

POST/api/v1/kroger/category

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

urlstring

A category listing URL (/pl/<name>/<id>) on kroger.com, qfc.com or fredmeyer.com. The URL's host sets the banner. Send url or taxonomy_id.

Example: https://www.fredmeyer.com/pl/headphones-earbuds-headsets/2900300001

taxonomy_idstring

The digits at the end of a /pl/ URL. Category ids are shared across banners.

Example: 08190

slugstring

The name part of a /pl/ URL. Optional with taxonomy_id; without it category.name is null.

Example: Import-Beer

bannerenum<string>default:kroger

The store banner. Prices differ by banner and by store. Only these three are served; other Kroger-family banners (Ralphs, King Soopers, Fry's, Smith's, Harris Teeter and the rest) are not available.

Example: fred_meyer

kroger — Kroger (kroger.com). The default.
qfc — QFC (qfc.com): Washington and Oregon.
fred_meyer — Fred Meyer (fredmeyer.com): the Pacific Northwest and Alaska, grocery plus general merchandise, apparel and home.

pageintegerdefault:1

Only page 1 is available (up to 24 products). A page above 1 is refused with a 400 before any charge. Narrow the query or use category for more specific results.

Example: 1

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# One aisle at QFC, by taxonomy id (ids are shared across banners).
r = client.kroger.category(taxonomy_id="08190", slug="Import-Beer", banner="qfc")["data"]
print(r["category"]["name"], r["total"], r["store"]["name"])
for p in r["products"]:
    print(p["upc"], p["name"], p["price"], p["promo_price"], p["promo_ends_at"])

Response

"banner": "qfc",

"page": 1,

"total": 65,

"count": 24,

"response_time": 3706

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # One aisle at QFC, by taxonomy id (ids are shared across banners). r = client.kroger.category(taxonomy_id="08190", slug="Import-Beer", banner="qfc")["data"] print(r["category"]["name"], r["total"], r["store"]["name"]) for p in r["products"]: print(p["upc"], p["name"], p["price"], p["promo_price"], p["promo_ends_at"])