Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Kroger

1 credit per call2 endpoints27 datapoints

Kroger API

Kroger API for grocery search and product details by UPC: prices, sale prices, unit prices, stock, aisle and diets as JSON. 1 credit per successful call.

Get a free API keyRun it below
Kroger
GET/v1/kroger/search?query=milk
{
  "success": true,
  "data": {
    "query": "milk",
    "page": 1,
    "count": 24,
    "has_next_page": false,
    "items": [
      {
        "position": 1,
        "id": "0001111050434",
        "upc": "0001111050434",
        "name": "Simple Truth Organic® Lactose Free Vitamin D Whole Milk Half Gallon",
        "brand": "Simple Truth",
        "url": "https://www.kroger.com/p/simple-truth-organic-lactose-free-vitamin-d-whole-milk-half-gallon/0001111050434",
        "image": "https://www.kroger.com/product/images/xlarge/front/0001111050434",
        "images": [
          "https://www.kroger.com/product/images/xlarge/front/0001111050434",
          "https://www.kroger.com/product/images/xlarge/back/0001111050434",
          "https://www.kroger.com/product/images/xlarge/right/0001111050434"
        ],
        "size": "1/2 gal",
        "currency": "USD",
        "categories": [
          "Dairy & Eggs > Milk & Dairy Free Milk > Whole Milk",
          "Dairy & Eggs > Milk & Dairy Free Milk > Lactose Free",
          "Natural & Organic > Dairy & Eggs > Milk"
        ],
        "diets": [
          "Kosher",
          "Lactose Free",
          "Pescatarian"
        ],
        "organic": false,
        "non_gmo": true,
        "snap_eligible": true,
        "origin": "UNITED STATES",
        "rating": {
          "average": 4,
          "count": 14
        },
        "stock_level": "high",
        "fulfillment": [
          "pickup"
        ],
        "aisle": {
          "number": "100",
          "description": "DAIRY",
          "side": "R"
        },
        "price": 3.99,
        "regular_price": 4.99,
        "sale_price": 3.99,
        "sale_ends": "2026-12-02T04:59:59.999Z",
        "unit_price": 0.0623,
        "unit": "fl oz",
        "unit_price_text": "$0.06/fl oz"
      },
      {
        "position": 2,
        "id": "0001111042861",
        "upc": "0001111042861",
        "name": "Simple Truth Organic® 2% Reduced Fat Milk with DHA Omega-3 Half Gallon",
        "brand": "Simple Truth",
        "url": "https://www.kroger.com/p/simple-truth-organic-2-reduced-fat-milk-with-dha-omega-3-half-gallon/0001111042861",
        "image": "https://www.kroger.com/product/images/xlarge/front/0001111042861",
        "images": [
          "https://www.kroger.com/product/images/xlarge/front/0001111042861",
          "https://www.kroger.com/product/images/xlarge/right/0001111042861",
          "https://www.kroger.com/product/images/xlarge/back/0001111042861"
        ],
        "size": "1/2 gal",
        "currency": "USD",
        "categories": [
          "Natural & Organic > Dairy & Eggs > Milk",
          "Dairy & Eggs > Milk & Dairy Free Milk > 1%, 2%, & Skim Milk"
        ],
        "diets": [
          "Kosher",
          "Pescatarian"
        ],
        "organic": false,
        "non_gmo": true,
        "snap_eligible": true,
        "origin": "UNITED STATES",
        "rating": {
          "average": 3.92,
          "count": 13
        },
        "stock_level": "temporarily_out_of_stock",
        "aisle": {
          "number": "100",
          "description": "DAIRY",
          "side": "R"
        },
        "price": 3.99,
        "regular_price": 4.99,
        "sale_price": 3.99,
        "sale_ends": "2026-12-02T04:59:59.999Z",
        "unit_price": 0.0623,
        "unit": "fl oz",
        "unit_price_text": "$0.06/fl oz"
      },
      {
        "position": 3,
        "id": "0001111042850",
        "upc": "0001111042850",
        "name": "Simple Truth Organic® Vitamin D Whole Milk Half Gallon",
        "brand": "Simple Truth",
        "url": "https://www.kroger.com/p/simple-truth-organic-vitamin-d-whole-milk-half-gallon/0001111042850",
        "image": "https://www.kroger.com/product/images/xlarge/front/0001111042850",
        "images": [
          "https://www.kroger.com/product/images/xlarge/front/0001111042850",
          "https://www.kroger.com/product/images/xlarge/back/0001111042850",
          "https://www.kroger.com/product/images/xlarge/right/0001111042850"
        ],
        "size": "1/2 gal",
        "currency": "USD",
        "categories": [
          "Natural & Organic > Dairy & Eggs > Milk",
          "Dairy & Eggs > Milk & Dairy Free Milk > Whole Milk"
        ],
        "diets": [
          "Kosher",
          "Pescatarian",
          "Vegetarian"
        ],
        "organic": false,
        "non_gmo": true,
        "snap_eligible": true,
        "origin": "UNITED STATES",
        "rating": {
          "average": 3.09,
          "count": 33
        },
        "stock_level": "high",
        "fulfillment": [
          "pickup"
        ],
        "aisle": {
          "number": "100",
          "description": "DAIRY",
          "side": "R"
        },
        "price": 3.99,
        "regular_price": 4.19,
        "sale_price": 3.99,
        "sale_ends": "2026-12-02T04:59:59.999Z",
        "unit_price": 0.0623,
        "unit": "fl oz",
        "unit_price_text": "$0.06/fl oz"
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_1fa8dec1d0774411a8eb47e35a244b8f",
    "credits_charged": 1,
    "credits_remaining": 1910
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#positionintegeridstringupcstringnamestringbrandstringurlurlimageurlimagesstring[]sizestringcurrencystringcategoriesstring[]dietsstring[]organicbooleannon_gmobooleansnap_eligiblebooleanoriginstringratingobjectstock_levelstringfulfillmentstring[]aisleobjectpricenumberregular_pricenumbersale_pricenumbersale_endsstringunit_pricenumberunitstringunit_price_textstring
1100011110504340001111050434Simple Truth Organic® Lactose Free Vitamin D Whole Milk Half GallonSimple Truthhttps://www.kroger.com/p/simple-truth-organic-lactose-free-vitamin-d-whole-milk-half-gallon/0001111050434https://www.kroger.com/product/images/xlarge/front/0001111050434[3 items]1/2 galUSD[3 items][3 items]falsetruetrueUNITED STATES{2 fields}high[1 item]{3 fields}3.994.993.992026-12-02T04:59:59.999Z0.0623fl oz$0.06/fl oz
2200011110428610001111042861Simple Truth Organic® 2% Reduced Fat Milk with DHA Omega-3 Half GallonSimple Truthhttps://www.kroger.com/p/simple-truth-organic-2-reduced-fat-milk-with-dha-omega-3-half-gallon/0001111042861https://www.kroger.com/product/images/xlarge/front/0001111042861[3 items]1/2 galUSD[2 items][2 items]falsetruetrueUNITED STATES{2 fields}temporarily_out_of_stock—{3 fields}3.994.993.992026-12-02T04:59:59.999Z0.0623fl oz$0.06/fl oz
3300011110428500001111042850Simple Truth Organic® Vitamin D Whole Milk Half GallonSimple Truthhttps://www.kroger.com/p/simple-truth-organic-vitamin-d-whole-milk-half-gallon/0001111042850https://www.kroger.com/product/images/xlarge/front/0001111042850[3 items]1/2 galUSD[2 items][3 items]falsetruetrueUNITED STATES{2 fields}high[1 item]{3 fields}3.994.193.992026-12-02T04:59:59.999Z0.0623fl oz$0.06/fl oz

Recorded from our API · 3 items shown · 27 datapoints per itemGET /v1/kroger/search?query=milk

27 datapoints

Identity

  • idstring
  • namestring
  • brandstring

Contact

  • urlurl

Reputation

  • imageurl
  • imagesstring[]
  • ratingobject

Price

  • currencystring
  • pricenumber
  • regular_pricenumber
  • sale_pricenumber
  • unit_pricenumber
  • unit_price_textstring

Other

  • positioninteger
  • upcstring
  • sizestring
  • categoriesstring[]
  • dietsstring[]
  • organicboolean
  • non_gmoboolean
  • snap_eligibleboolean
  • originstring
  • stock_levelstring
  • fulfillmentstring[]
  • aisleobject
  • sale_endsstring
  • unitstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/kroger/search?query=milk" \
  -H "X-API-Key: $API_KEY"

Kroger · 2 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/kroger/product
none+2 optional
1 credit
GET/v1/kroger/search
query+1 optional
1 credit

Overview

What you can get

The Kroger API returns Kroger grocery data as JSON through 2 endpoints.

  • Search: search takes a query, with page (1).
  • Products: product takes a upc or a product url.

The recorded search for "milk" returns query, page, count, has_next_page and items. Each item has position, upc, name, brand, size, categories, diets, organic, non_gmo, snap_eligible, rating, stock_level, fulfillment, aisle, price, regular_price, sale_price, sale_ends, unit_price, unit and unit_price_text.

How a call works

Search, then look up: GET /v1/kroger/search?query=milk with your key in the X-API-Key header returns each product's upc; product takes a upc. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track grocery prices and sale prices for a basket of products

Use the Kroger API to track grocery prices and sale prices for a basket of products

Compare unit prices across brands for one product type

Use the Kroger API to compare unit prices across brands for one product type

Watch when a sale ends with `sale_ends`

Use the Kroger API to watch when a sale ends with `sale_ends`

Check stock levels and pickup availability

Use the Kroger API to check stock levels and pickup availability

FAQ

Questions

How much does the Kroger API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

Do I need a Kroger account?

No. You call this Kroger API with your Perceptlayer key in the `X-API-Key` header, with no Kroger login.

Does it show sale prices?

Yes. Search items carry `price`, `regular_price`, `sale_price` and `sale_ends`.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Kroger scraper instead?

You can, but a Kroger scraper is code you maintain: page changes break it, requests get blocked, and Kroger's terms govern how you collect data. The Kroger API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Kroger API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs