---
title: "Whole Foods Market API: Search | Perceptlayer"
description: "Search from Whole Foods Market as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/whole-foods/search
---

[APIs](https://perceptlayer.com/apis) / [Whole Foods Market](https://perceptlayer.com/apis/whole-foods) / Search

# Whole Foods Market: Search

Search from Whole Foods Market as JSON. 1 credit per successful call.

GET `/v1/whole-foods/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | Required | Up to 120 characters |
| `store_id` | string | Required | Any |
| `page` | integer | Optional | Any |
| `per_page` | integer | Optional | Any |
| `category` | string | Optional | Up to 80 characters |
| `diet` | string | Optional | Up to 60 characters |

## Example request

Whole Foods Market

GET /v1/whole-foods/search?query=milk&store\_id=10245 

```
{
  "success": true,
  "data": {
    "query": "milk",
    "store_id": "10245",
    "page": 1,
    "per_page": 24,
    "total_results": 514,
    "has_next_page": true,
    "items": [
      {
        "position": 1,
        "id": "B082VVT75S",
        "name": "Unsweetened Oat Milk, 32 FZ",
        "brand": "Elmhurst",
        "url": "https://www.wholefoodsmarket.com/product/elmhurst-unsweetened-oat-milk-32-fz-b082vvt75s",
        "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41W8VdoCfGL.jpg",
        "is_local": true,
        "currency": "USD",
        "price": 7.29,
        "regular_price": 7.29,
        "on_sale": false
      },
      {
        "position": 2,
        "id": "B07HFJJ49P",
        "name": "Unsweetened Almond Milk, 32 FZ",
        "brand": "Elmhurst",
        "url": "https://www.wholefoodsmarket.com/product/elmhurst-unsweetened-almond-milk-32-fz-b07hfjj49p",
        "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41wCG4yX-9L.jpg",
        "is_local": true,
        "currency": "USD",
        "price": 7.29,
        "regular_price": 7.29,
        "on_sale": false
      },
      {
        "position": 3,
        "id": "B078WVT2BC",
        "name": "Unsweetened Hazelnut Milked, 32 FZ",
        "brand": "Elmhurst",
        "url": "https://www.wholefoodsmarket.com/product/elmhurst-unsweetened-hazelnut-milked-32-fz-b078wvt2bc",
        "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41Z7pgsEWEL.jpg",
        "is_local": true,
        "currency": "USD",
        "price": 7.29,
        "regular_price": 7.29,
        "on_sale": false
      }
    ],
    "facets": [
      {
        "key": "category",
        "label": "Category",
        "options": [
          {
            "slug": "all-products",
            "label": "All Search Results",
            "count": 514
          },
          {
            "slug": "dairy-eggs",
            "label": "Dairy & Eggs",
            "count": 348,
            "options": [
              "…",
              "…",
              "…"
            ]
          },
          {
            "slug": "prepared-foods",
            "label": "Prepared Foods",
            "count": 2,
            "options": [
              "…"
            ]
          }
        ]
      },
      {
        "key": "featured",
        "label": "Featured",
        "options": [
          {
            "slug": "on-sale",
            "label": "Sales & Deals",
            "count": 248
          },
          {
            "slug": "365-by-whole-foods-market",
            "label": "365 by Whole Foods Market",
            "count": 73
          },
          {
            "slug": "local",
            "label": "Local",
            "count": 37
          }
        ]
      },
      {
        "key": "diets",
        "label": "Dietary Preference",
        "options": [
          {
            "slug": "vegan",
            "label": "Vegan",
            "count": 52
          },
          {
            "slug": "gluten-free",
            "label": "Gluten-Free",
            "count": 111
          },
          {
            "slug": "organic",
            "label": "Organic",
            "count": 223
          }
        ]
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_879324b5d62f4830a8a5d093a16a2e43",
    "credits_charged": 1,
    "credits_remaining": 1908
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/whole-foods?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.