kingsoopers.com APIkingsoopers.com ↗
Search King Soopers store locations by ZIP code and query product prices, UPCs, and brand data via two REST endpoints.
curl -X GET 'https://api.parse.bot/scraper/d582b495-7b6d-4ae8-bdf9-c163d00df8b6/search_stores?zip_code=80202' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for King Soopers store locations near a ZIP code. Returns store details including locationId, address, phone, hours, departments, and distance.
| Param | Type | Description |
|---|---|---|
| zip_coderequired | string | ZIP code to search for nearby stores (e.g. '80202'). |
{
"type": "object",
"fields": {
"stores": "array of store objects with locationId, locale, phoneNumber, prettyHours, departments, facilityId, distance, and other store metadata"
},
"sample": {
"data": {
"stores": [
{
"brand": "KINGSOOPERS",
"isOpen": true,
"locale": {
"address": {
"name": "CEDARWOOD",
"cityTown": "Springfield",
"postalCode": "62704",
"countryCode": "US",
"addressLines": [
"123 Main St"
],
"stateProvince": "IL"
},
"location": {
"lat": 40.5741644,
"lng": -105.1169274
}
},
"distance": {
"pretty": "1.09 miles"
},
"facilityId": "12524",
"locationId": "62000009",
"vanityName": "CEDARWOOD"
}
]
},
"status": "success"
}
}About the kingsoopers.com API
The King Soopers API provides 2 endpoints that cover store discovery and product search across King Soopers locations. Use search_stores to find nearby stores by ZIP code — getting back addresses, phone numbers, hours, and department listings — then pass a location_id into search_products to retrieve product names, prices, unit sizes, UPCs, and brand data for any list of search terms.
Store Lookup
The search_stores endpoint accepts a zip_code string and returns an array of store objects. Each object includes a locationId (used to scope product searches), locale, phoneNumber, prettyHours, facilityId, distance from the searched ZIP, and a departments list indicating which services — pharmacy, deli, bakery, etc. — are available at that location.
Product Search
The search_products endpoint accepts a location_id, a queries array of search terms (e.g. ["milk", "eggs"]), and an optional limit per query. Each term is searched independently and results are combined into a single results array. Every product object surfaces Product Name, Price, Unit/Size, UPC, Brand, and Item Searched, so you always know which query term a result came from.
Data Scope
Coverage is specific to King Soopers, a Kroger-family banner operating primarily in Colorado and Wyoming. Product prices and availability reflect the selected store location, so results can differ across location_id values. Queries that return no matches for a given store are omitted from the combined result set rather than surfaced as errors.
- Build a store locator that shows King Soopers locations, hours, and departments near any ZIP code.
- Track grocery price changes over time for specific items using the
PriceandUPCfields. - Compare prices on a shopping list across multiple store locations by varying
location_id. - Look up UPC codes for King Soopers products to cross-reference with other retail data sources.
- Identify which nearby stores carry a pharmacy or deli using the
departmentsfield before sending product queries. - Aggregate brand availability data for CPG market research using
BrandandItem Searchedfields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does King Soopers have an official developer API?+
What does the `search_stores` endpoint return beyond address and phone?+
locationId, locale, phoneNumber, prettyHours, facilityId, distance from the queried ZIP, and a departments array. The locationId is required as an input to search_products, so calling search_stores first is the standard workflow.Does `search_products` return stock availability or aisle location?+
Product Name, Price, Unit/Size, UPC, Brand, and Item Searched, but do not include in-stock status, aisle numbers, or inventory counts. You can fork this API on Parse and revise it to add an endpoint targeting those fields if they become accessible.Can I retrieve weekly ad deals or digital coupon data?+
How does the `queries` array work in `search_products`?+
queries array is searched independently against the specified store. Results from all queries are merged into one results array, and each product object includes an Item Searched field indicating which query term produced it. The optional limit parameter caps results per individual query term, not the total combined result count.