Whole Foods API

No. Whole Foods Market has no public product API; its official data exchange is supplier EDI only. The Scavio Whole Foods API fills that gap with 7 POST endpoints that return wholefoodsmarket.com data as JSON: search, category, deals, product, store locator, store details and the weekly sales flyer.

It is a REST API that returns public Whole Foods Market product, price, store and flyer data as structured JSON, priced at the store you choose. Every endpoint costs 1 credit per call.

No. Whole Foods prices are set per store, so search, category and deals are priced at one store: pass a 5-digit store_id, or the API uses store 10145 (Lamar, Austin TX). In our capture at store 10160 (Columbus Circle, New York), Elmhurst Unsweetened Hazelnut Milked, 32 FZ, was $7.29.

Yes. Every product row carries regular_price, sale_price and prime_price, the Prime member price, with sale_start_date and sale_end_date. sale_price and prime_price are null when the store has no sale or Prime price on the item.

As a total plus a quantity. sale_price 12.23 with sale_quantity 3 means 3 for $12.23; prime_quantity works the same way for prime_price. price_unit lb means the price is per pound.

Whole Foods prices the shelf and online orders separately. The product endpoint returns both for one store as separately labelled blocks: in_store (shelf regular, sale and Prime price) and online (delivery and pickup price, unit price and availability). In our capture the same hazelnut milk was $7.29 on the shelf and $7.49 online.

POST a ZIP code to /api/v1/wholefoods/stores. It returns stores nearest first within 15 miles, widening to 50, each with store_id, name, address, phone, coordinates, distance and seven days of hours. ZIP 10019 returned 29 stores, the nearest 0.42 miles away.

Yes. /api/v1/wholefoods/sales-flyer returns a store's current flyer: each promotion's product, brand, headline, terms, regular, sale and Prime price, start and end dates, rank and the ASINs it covers. Flyer prices are text as printed, such as "$3.99/lb" or "44% off". For numeric sale prices, use deals.

No. Whole Foods does not publish per-store unit counts, so there is no quantity or stock level. A product appears in search, category and deals when that store's catalog carries it, and the product endpoint's online.availability is the online offer's status.

No. Whole Foods shows no product ratings, reviews or UPCs, so the API returns none. The product id is the ASIN, which every search result carries.

Yes, from /api/v1/wholefoods/product: ingredients, a nutrition panel with calories, serving size and every nutrient with its daily value, diets such as vegan or gluten_free, SNAP EBT eligibility and images.

Search sorts by relevance (the default) or price, ascending or descending, and nothing else. Category and deals add featured, popular and brand A-Z or Z-A. All three filter by diet (vegan, gluten-free, organic, dairy-free, vegetarian), and search and category also take on_sale. Up to 60 products per page; page with offset.

Prices are per store, so results are only as local as the store_id you pass (default 10145, Austin TX). In-store and online prices can differ. There are no ratings, reviews, UPCs or per-store unit counts, only presence in the store's catalog. Search sorts only by relevance or price. Flyer prices are display text. The product id is the ASIN.

Every Whole Foods endpoint costs 1 credit per successful call. Errors such as an unknown product, store or category (404) or a temporary outage (502) are not charged. New accounts get 50 free credits on signup, one time, with no card required. Paid plans start at $30 per month for 7,000 credits.

Every request fetches live from Whole Foods Market at the moment you call it, and nothing is cached. Each response carries fetched_at, the time the data was retrieved.

Scavio returns publicly available Whole Foods Market product data and does not access accounts or order history. You remain responsible for how you use the data, including compliance with Whole Foods' terms. Talk to your own counsel for your specific use case.