Kroger Product API returns one grocery product from kroger.com by its UPC. It adds the description, ingredients, allergen statement, the nutrition panel (serving size, calories, fats, carbohydrates, protein and daily values) and nutritional claims to the fields of the search route.
Send either upc (12 or 13 digits, as returned by search, for example 0001111041660) or url (a kroger.com product page, where the UPC is the last path part). Only the product with exactly this UPC is returned. An unknown UPC answers 404 and is free. Kroger picks the store from the network location of the request, so prices, sale prices and stock can differ between calls. Prices are in US dollars. Fields Kroger does not publish for a product are left out.
Costs 1 credit per successful request. Not found and failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
2 optional filters available.
string
Optional
Product UPC, 12 or 13 digits, as returned by search, for example 0001111041660. Required unless url is sent.
example
string
Optional
A kroger.com product page URL, for example https://www.kroger.com/p/kroger-1-lowfat-milk-gallon/0001111041660. Required unless upc is sent.
https://example.com/product
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"product": {
"id": "0001111041660",
"upc": "0001111041660",
"url": "https://www.kroger.com/p/kroger-1-lowfat-milk-gallon/0001111041660",
"name": "Kroger\u00ae 1% Lowfat Milk Gallon",
"size": "1 gal",
"unit": "fl oz",
"aisle": {
"side": "R",
"number": "100",
"description": "DAIRY"
},
"brand": "Kroger",
"diets": [
"Kosher",
"Pescatarian",
"Vegetarian"
],
"image": "https://www.kroger.com/product/images/xlarge/front/0001111041660",
"price": 3.19,
"images": [
"https://www.kroger.com/product/images/xlarge/front/0001111041660",
"https://www.kroger.com/product/images/xlarge/back/0001111041660"
],
"origin": "UNITED STATES",
"rating": {
"count": 22,
"average": 3.23
},
"non_gmo": false,
"organic": false,
"currency": "USD",
"allergens": "Contains Milk and its derivates.",
"nutrition": {
"nutrients": [
{
"name": "Sodium",
"unit": "mg",
"amount": 105,
"daily_value_percent": 5
},
{
"name": "Total Carbohydrate",
"unit": "g",
"amount": 12,
"daily_value_percent": 5
},
{
"name": "Trans Fat",
"unit": "g",
"amount": 0
},
{
"name": "Calories",
"unit": "kcal",
"amount": 100
}
],
"prepared_as": "Unspecified",
"serving_size": "8 fl oz (240mL)",
"servings_per_container": 16
},
"categories": [
"Dairy & Eggs > Milk & Dairy Free Milk > 1%, 2%, & Skim Milk"
],
"unit_price": 0.0249,
"description": "Kroger\u00ae 1% Lowfat Milk Gallon brings a refreshing start to your morning. Smooth and creamy flavor, that'll satisfy your taste buds with every glass. A perfect addition to baking your favorite recipes.\nKroger\u00ae \u2013 Trusted for the everyday moments that matter.\n- 1 gal Jug of Kroger\u00ae 1% Lowfat Milk Gallon\n- Refreshing and creamy with vitamins A & D\n- Lowfat, but uncompromising in flavor\n- A perfect partner for coffee and cereal\n- Kroger\u00ae quality you can trust",
"fulfillment": [
"pickup"
],
"ingredients": "Skim Milk, Milk, Vitamin A Palmitate, Vitamin D3.",
"stock_level": "high",
"regular_price": 3.19,
"snap_eligible": true,
"unit_price_text": "$0.02/fl oz",
"nutritional_claims": [
"Low Sodium",
"Low Fat",
"No Artificial Ingredients",
"No Added Sugar",
"Live Naturally"
]
}
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "product"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
Neither upc nor url was sent, or a value is invalid. This response is not billable.
{
"errors": {
"upc": [
"A upc or a url is required, e.g. upc=0001111041660."
]
},
"message": "The request validation failed"
}Not Found
No product with this exact UPC was found. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Kroger could not be reached after several tries. This response is not billable. Retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Kroger could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.