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.
curl "https://www.socialcrawl.dev/v1/kroger/search?query=milk" \
-H "x-api-key: YOUR_API_KEY"{
"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
1 endpoint available.
| Endpoint | Path | Credit Tier |
|---|---|---|
| Search Kroger products | /v1/kroger/search | standard (1cr) |
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.
