APIs / Whole Foods Market / 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.

ParameterTypeRequiredAllowed values
querystringRequiredUp to 120 characters
store_idstringRequiredAny
pageintegerOptionalAny
per_pageintegerOptionalAny
categorystringOptionalUp to 80 characters
dietstringOptionalUp 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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.