# Whole Foods Market — 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.

> Search for grocery products, browse weekly sales, and find store locations at Whole Foods Market. Returns pricing, availability, ingredients, and nutritional information.

**Category:** Food & Dining | **Website:** [wholefoodsmarket.com/](https://wholefoodsmarket.com/) | **Docs:** [parse.bot/marketplace/a5eca994-e76f-416b-a6bb-23ffeaadc358/wholefoodsmarket-com-api](https://parse.bot/marketplace/a5eca994-e76f-416b-a6bb-23ffeaadc358/wholefoodsmarket-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/whole-foods-market/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Find stores

Find Whole Foods Market stores by ZIP code or city/store name. For ZIP codes, returns the nearest store. For city names, searches store tokens for matches. Returns store details including address, hours, coordinates, and Prime eligibility.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | 5-digit ZIP code (e.g., '10001') or city/store name (e.g., 'beverlyhills') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/whole-foods-market/find-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Get product details

Retrieve details for a specific product by its ASIN. Returns product name, brand, description, ingredients, images, diet types, and pricing when store context is available. Pricing may be null if the product page lacks store-specific offer data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product ASIN (e.g., 'B074H5SR5S') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/whole-foods-market/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### Get weekly sales

Retrieve current weekly sales promotions for a specific Whole Foods store. Returns promotional items with regular, sale, and Prime member prices, validity dates, and associated product ASINs. Use find_stores to discover valid store IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_id` | string | No | Store ID number (e.g., '10746'). Use find_stores to discover store IDs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/whole-foods-market/get-weekly-sales \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"store_id":"<string>"}'
```

### Search products

Search for grocery products by keyword. Returns products with pricing, availability, ingredients, and nutritional info. Uses ZIP code to determine store location for pricing. Pagination is not supported; use limit to control result count (max 30).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (max 30) |
| `query` | string | Yes | Search keyword (e.g., 'milk', 'organic bread') |
| `zip_code` | string | No | 5-digit US ZIP code for location-specific pricing and availability |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/whole-foods-market/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","zip_code":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.