# 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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/parse-wholefoodsmarket-com-api-a5eca994/find_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wholefoodsmarket-com-api-a5eca994/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wholefoodsmarket-com-api-a5eca994/get_weekly_sales \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wholefoodsmarket-com-api-a5eca994/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","zip_code":"<string>"}'
```