# Kroger (/docs/kroger) Search Kroger groceries with each product's UPC, price, sale price and stock, for one store when you name it Kroger is the largest supermarket chain in the United States. This endpoint searches Kroger's products by keyword and returns each product's UPC, price in US dollars, the regular price when it is on sale, stock and pack size. Pass `store_id` to read one store's prices and stock. Every result uses the canonical `Product` shape, and the Kroger-only facts sit in `product.ext.kroger`. Base URL: `/v1/kroger/...` Kroger exposes 1 routes here. ## Quickstart ### Search products Pass product keywords as `query`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/kroger/search?query=milk" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "items": [ { "product": { "id": "0001111042850", "title": "Simple Truth OrganicĀ® Vitamin D Whole Milk Half Gallon", "price": { "current": 3.99, "original": 4.29, "currency": "USD" }, "availability": "In stock", "ext": { "kroger": { "size": "1/2 gal", "store_id": null } } } } ] } } ``` ## Questions people ask ### Can I get one store's prices? Yes. Pass `store_id`, the Kroger store's number. `product.ext.kroger.store_id` then names that store on every row. ### How do I see a sale? On sale, `product.price.original` is the regular price and `product.price.current` the sale price. Otherwise `original` is null. ### Why is there no rating? Kroger shows no star rating on these surfaces, so the rating leaves are null. ## All endpoints ## Platform notes **Search returns one page.** The first 24 matches; refine the query to reach others. **The product id is the UPC.** `product.id` is the 13-digit UPC Kroger uses in its product links. ## Next steps - [Sprouts](/docs/sprouts.md): Natural and organic groceries in the same Product shape. - [Errors](/docs/errors.md): What each status means and which ones are refunded.