--- title: "Kroger API: JSON data, 2 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/kroger --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Kroger 1 credit per call 2 endpoints 27 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | position integer | id string | upc string | name string | brand string | url url | image url | images string\[\] | size string | currency string | categories string\[\] | diets string\[\] | organic boolean | non\_gmo boolean | snap\_eligible boolean | origin string | rating object | stock\_level string | fulfillment string\[\] | aisle object | price number | regular\_price number | sale\_price number | sale\_ends string | unit\_price number | unit string | unit\_price\_text string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1 | 0001111050434 | 0001111050434 | Simple Truth Organic® Lactose Free Vitamin D Whole Milk Half Gallon | Simple Truth | https://www.kroger.com/p/simple-truth-organic-lactose-free-vitamin-d-whole-milk-half-gallon/0001111050434 | https://www.kroger.com/product/images/xlarge/front/0001111050434 | \[3 items\] | 1/2 gal | USD | \[3 items\] | \[3 items\] | false | true | true | UNITED STATES | {2 fields} | high | \[1 item\] | {3 fields} | 3.99 | 4.99 | 3.99 | 2026-12-02T04:59:59.999Z | 0.0623 | fl oz | $0.06/fl oz | | 2 | 2 | 0001111042861 | 0001111042861 | Simple Truth Organic® 2% Reduced Fat Milk with DHA Omega-3 Half Gallon | Simple Truth | https://www.kroger.com/p/simple-truth-organic-2-reduced-fat-milk-with-dha-omega-3-half-gallon/0001111042861 | https://www.kroger.com/product/images/xlarge/front/0001111042861 | \[3 items\] | 1/2 gal | USD | \[2 items\] | \[2 items\] | false | true | true | UNITED STATES | {2 fields} | temporarily\_out\_of\_stock | — | {3 fields} | 3.99 | 4.99 | 3.99 | 2026-12-02T04:59:59.999Z | 0.0623 | fl oz | $0.06/fl oz | | 3 | 3 | 0001111042850 | 0001111042850 | Simple Truth Organic® Vitamin D Whole Milk Half Gallon | Simple Truth | https://www.kroger.com/p/simple-truth-organic-vitamin-d-whole-milk-half-gallon/0001111042850 | https://www.kroger.com/product/images/xlarge/front/0001111042850 | \[3 items\] | 1/2 gal | USD | \[2 items\] | \[3 items\] | false | true | true | UNITED STATES | {2 fields} | high | \[1 item\] | {3 fields} | 3.99 | 4.19 | 3.99 | 2026-12-02T04:59:59.999Z | 0.0623 | fl oz | $0.06/fl oz | Recorded from our API · 3 items shown · 27 datapoints per item GET /v1/kroger/search?query=milk 27 datapoints ### Identity - id string - name string - brand string ### Contact - url url ### Reputation - image url - images string\[\] - rating object ### Price - currency string - price number - regular\_price number - sale\_price number - unit\_price number - unit\_price\_text string ### Other - position integer - upc string - size string - categories string\[\] - diets string\[\] - organic boolean - non\_gmo boolean - snap\_eligible boolean - origin string - stock\_level string - fulfillment string\[\] - aisle object - sale\_ends string - unit string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/kroger/product`](https://perceptlayer.com/apis/kroger/product) | none +2 optional | 1 credit | | [GET `/v1/kroger/search`](https://perceptlayer.com/apis/kroger/search) | `query` +1 optional | 1 credit | Overview ## About the Kroger API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)