kroger.com APIwww.kroger.com ↗
Access Kroger grocery store locations across the US. Get store directories by state, detailed city-level info, and proximity search by city, zip, or address.
curl -X GET 'https://api.parse.bot/scraper/91b3d669-c6ee-4818-bf5b-461d3d18cbe3/get_all_stores?state=Ohio' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the complete directory of all Kroger grocery stores grouped by state. Returns all states, cities, and store counts. Optionally filter by state name.
| Param | Type | Description |
|---|---|---|
| state | string | Filter by state name (partial match, e.g. 'Georgia', 'Ohio'). Omitting returns all states. |
{
"type": "object",
"fields": {
"states": "object mapping state name to city list with city_count and cities array",
"total_cities": "integer total number of cities across all states",
"total_states": "integer total number of states in the directory",
"total_stores": "integer total number of stores across all states"
},
"sample": {
"data": {
"states": {
"Ohio": {
"cities": [
{
"name": "Amelia",
"url_slug": "/stores/grocery/oh/amelia"
},
{
"name": "Athens",
"url_slug": "/stores/grocery/oh/athens"
}
],
"city_count": 114
}
},
"total_cities": 669,
"total_states": 16,
"total_stores": 1230
},
"status": "success"
}
}About the kroger.com API
The Kroger Store Locations API exposes 3 endpoints covering the full US store directory, returning fields like address, phone, hours, departments, and GPS coordinates for every Kroger location. Use get_all_stores to retrieve a state-by-state directory with city counts, get_stores_by_city for granular store details in a specific city, or search_stores to find nearby locations by zip code, city name, or street address.
Store Directory by State
The get_all_stores endpoint returns the complete Kroger store directory organized as a mapping of state names to city arrays, each with a city-level store count. The response includes top-level aggregates: total_states, total_cities, and total_stores. Pass the optional state parameter with a partial name match (e.g., 'Georgia' or 'Ohio') to narrow results to a single state without fetching the full directory.
City-Level Store Details
get_stores_by_city accepts a required city string and two-letter state abbreviation and returns an array of store objects for that city. Each object includes location_id, name, brand, address, zip_code, phone, hours, departments, and latitude/longitude coordinates. The store_count field tells you how many locations exist in that city, and state_name gives the full state name alongside the abbreviation.
Proximity Search
search_stores accepts a freeform query — a city name, zip code, or street address — and returns stores sorted by proximity to that location. The same detailed store fields are included as in get_stores_by_city. Use page_size and page_offset to paginate through larger result sets; a pagination metadata object is included in the response, though it may be empty for small result sets.
Data Coverage
All three endpoints cover Kroger-branded grocery stores across the United States. The brand field in store objects reflects the specific banner (e.g., Kroger, Ralphs, Fred Meyer, King Soopers) since Kroger Co. operates under several regional names, though only Kroger-banner stores are indexed here.
- Build a store locator map using latitude/longitude coordinates from
get_stores_by_cityorsearch_stores. - Analyze Kroger's geographic footprint by state using
total_storesandtotal_citiesfromget_all_stores. - Identify which departments (pharmacy, deli, fuel center) are available at stores near a given zip code.
- Power a mobile app feature that finds the nearest Kroger by querying
search_storeswith a user's zip code. - Aggregate store hours data to determine which locations offer extended or 24-hour service.
- Compare store density across cities by combining city-level
store_countvalues from the state directory. - Validate or enrich an existing retail database with canonical Kroger
location_id, address, and phone fields.
| 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 Kroger have an official developer API for store locations?+
What store details does `get_stores_by_city` return beyond the address?+
phone, hours, a departments array (listing amenities like pharmacy or fuel center), latitude and longitude for mapping, a brand field indicating the banner name, and a unique location_id. The store_count in the response tells you how many stores are in that city.Does `search_stores` return results for all Kroger banner brands like Ralphs or Fred Meyer?+
brand field in the response reflects this scope. You can fork the API on Parse and revise it to target those banner-specific store directories and add the missing coverage.Can I retrieve product prices or inventory data through this API?+
How does pagination work in `search_stores`?+
page_size to control how many store results are returned per request and page_offset to step through pages. The response includes a pagination metadata object, though it may be empty when the result set is smaller than the page size. store_count always reflects the number of stores in the current response page.