# Kroger — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find Kroger grocery store locations across the US organized by state, city, and search parameters. Get detailed store information including directories and specifics for any Kroger location in your area.

**Category:** Food & Dining | **Website:** [www.kroger.com/stores/grocery](https://www.kroger.com/stores/grocery) | **Docs:** [parse.bot/marketplace/9df31a3b-8dbe-41a3-94c3-c11ce52668b7/kroger-com-api](https://parse.bot/marketplace/9df31a3b-8dbe-41a3-94c3-c11ce52668b7/kroger-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-kroger-com-api-9df31a3b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_stores

Get the complete directory of all Kroger grocery stores grouped by state. Returns all states with their cities and store counts. The optional state filter narrows results to matching states (partial, case-insensitive). Returns a single Directory object, not a list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | Filter by state name (partial match, case-insensitive). Omitting returns all states. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kroger-com-api-9df31a3b/get_all_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### get_stores_by_city

Get detailed store information for all Kroger grocery stores in a specific city. Returns full store records including address, phone, hours, departments, and coordinates. The city and state combination must match a valid entry in the Kroger store directory.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name, lowercased (e.g. 'acworth', 'atlanta', 'little rock') |
| `state` | string | Yes | Two-letter state abbreviation, lowercased (e.g. 'ga', 'oh', 'tx') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kroger-com-api-9df31a3b/get_stores_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","state":"<string>"}'
```

### search_stores

Search for Kroger stores by location query (city name, zip code, or address). Returns stores near the searched location. Results include all store types in the Kroger family (grocery, fuel, shell). Pagination via page_size and page_offset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_offset` | integer | No | Pagination offset (number of results to skip) |
| `page_size` | integer | No | Number of results per page |
| `query` | string | Yes | Search query - city name, zip code, or address (e.g. 'Atlanta', '30301') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kroger-com-api-9df31a3b/search_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_offset":"<integer>","page_size":"<integer>","query":"<string>"}'
```