Kroger Grocery Products Scraper

Scrapes grocery products, prices, and availability from Kroger via the official Kroger API.

API Source

• Base URL: https://api.kroger.com/v1
• API Key: REQUIRED - Get credentials at developer.kroger.com

Features

• Search products by term or category
• Get real-time pricing and availability
• Store-specific inventory and fulfillment options
• Automatic store location lookup by ZIP code
• Pagination support for large result sets

Input Parameters

Parameter	Type	Required	Default	Description
searchTerm	string	No*	-	Product search term (e.g., 'milk', 'bread', 'organic apples')
category	string	No*	-	Product category to browse
locationId	string	No	-	Kroger store location ID for pricing and availability
zipCode	string	No	"45202"	ZIP code to find nearby stores (alternative to locationId)
clientId	string	Yes	-	Kroger API client ID from developer.kroger.com
clientSecret	string	Yes	-	Kroger API client secret from developer.kroger.com
limit	integer	No	50	Maximum number of products to return (max: 500)

*At least one of searchTerm or category is required.

Example Input

{
    "searchTerm": "organic milk",
    "zipCode": "45202",
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "limit": 100
}

Output Fields

Each product record contains the following fields:

Field	Type	Description
productId	string	Unique Kroger product identifier
upc	string	Universal Product Code
aisleLocations	array	In-store aisle location information
brand	string	Product brand name
categories	array	Product category hierarchy
description	string	Product description
images	array	Product images (see below)
countryOrigin	string	Country of origin
temperature	string	Storage temperature requirements
price	object	Pricing information (see below)
fulfillment	object	Fulfillment availability (see below)
storeLocationId	string	Store location used for pricing
scrapedAt	string	ISO 8601 timestamp of when data was scraped

Images Array

{
    "perspective": "front",
    "size": "large",
    "url": "https://..."
}

Price Object

{
    "regular": 4.99,
    "promo": 3.99,
    "regularPerUnitEstimate": 0.31,
    "promoPerUnitEstimate": 0.25
}

Fulfillment Object

{
    "curbside": true,
    "delivery": true,
    "inStore": true,
    "shipToHome": false
}

Example Output

{
    "productId": "0001111041700",
    "upc": "0001111041700",
    "aisleLocations": [{"description": "Dairy Aisle 7"}],
    "brand": "Kroger",
    "categories": ["Dairy", "Milk", "Organic Milk"],
    "description": "Kroger Organic 2% Reduced Fat Milk",
    "images": [
        {
            "perspective": "front",
            "size": "large",
            "url": "https://www.kroger.com/product/images/large/front/..."
        }
    ],
    "countryOrigin": "USA",
    "temperature": "Refrigerated",
    "price": {
        "regular": 5.99,
        "promo": 4.99,
        "regularPerUnitEstimate": 0.047,
        "promoPerUnitEstimate": 0.039
    },
    "fulfillment": {
        "curbside": true,
        "delivery": true,
        "inStore": true,
        "shipToHome": false
    },
    "storeLocationId": "01400441",
    "scrapedAt": "2026-01-25T12:00:00.000Z"
}

Getting Kroger API Credentials

1. Go to developer.kroger.com
2. Create a developer account
3. Create a new application
4. Copy your Client ID and Client Secret
5. Use these credentials in the scraper input

Usage on Apify

1. Navigate to the actor on Apify
2. Enter your Kroger API credentials
3. Specify a search term or category
4. Optionally set a ZIP code for store-specific pricing
5. Run the actor

Local Development

# Install dependencies
npm install

# Run with Apify CLI
apify run -i '{"searchTerm": "milk", "clientId": "xxx", "clientSecret": "xxx"}'

Rate Limiting

The scraper includes built-in rate limiting (500ms delay between requests) to comply with Kroger API guidelines.

Supported Kroger Banners

The Kroger API covers products from all Kroger-owned stores:

• Kroger
• Ralphs
• Fred Meyer
• King Soopers
• Fry's
• Smith's
• QFC
• And more...

License

ISC