Kroger

Kroger Store Locator API

Kroger, QFC or Fred Meyer stores near a US ZIP or a city or address (up to 50, nearest first), or one store by store_id. Each location: location_id (the store_id for prices, coupons and suggestions), banner, type (store or fuel_center), name, store number, address, coordinates, phone, timezone, opening hours, departments with their phones and hours, pharmacy and fuel center flags, pickup, delivery and distance in miles. Costs 1 credit per request.

POST/api/v1/kroger/stores

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

zipstring

A 5-digit US ZIP code. Send exactly one of zip, query or store_id.

Example: 97201

querystring

A city or address, as typed in the site's store finder, 2-100 characters.

Example: Portland, OR

store_idstring

One store's 8-digit location_id.

Example: 70100011

bannerenum<string>

The store banner. Optional with store_id: QFC ids start with 705, Fred Meyer ids with 701, anything else is kroger. A banner that contradicts the id is a 400.

Example: qfc

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.

limitintegerdefault:10

Locations to return, 1-50.

Example: 20

include_other_bannersbooleandefault:false

Also return nearby locations of other Kroger banners (for example Fred Meyer stores near a QFC search, or Fred Meyer Jewelers). Partner fuel stations are never returned.

Example: false

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Fred Meyer stores near Portland 97201; fuel centers are their own entries.
r = client.kroger.stores(zip="97201", banner="fred_meyer")["data"]
for s in r["stores"]:
    if s["type"] == "store":
        print(s["location_id"], s["name"], s["distance_miles"], s["has_pharmacy"])

Response

"banner": "fred_meyer",

"count": 10,

"query": "97201"

"response_time": 3075

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Fred Meyer stores near Portland 97201; fuel centers are their own entries. r = client.kroger.stores(zip="97201", banner="fred_meyer")["data"] for s in r["stores"]: if s["type"] == "store": print(s["location_id"], s["name"], s["distance_miles"], s["has_pharmacy"])