Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Whole Foods documentation

Whole Foods Search API Alpha

Search public products on Whole Foods. Prices and availability are returned only when present in the retailer response and may depend on location. Set store_id to select a store. Requests fail when data for that store is unavailable.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/wholefoods/search

// from request to code

Integrate Whole Foods Search

Build your request and copy it into your stack. Or let your coding agent set it up.

APIWhole Foods Search
More options 2
Request parameters

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/wholefoods/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "coffee",
  "store_id": "10233"
}'

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/wholefoods/search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "query": "coffee",
  "store_id": "10233"
}

// request reference

Whole Foods Search parameters

Send query parameters with GET /api/wholefoods/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

query
QueryRequired

Product keywords to search for.

Type string · GET query or POST JSON

  • Minimum characters: 1
  • Maximum characters: 500
page
PageOptional

One-based result page.

Type integer · GET query or POST JSON · Default 1

  • Minimum: 1
  • Maximum: 100
store_id
Store IDOptional

Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.

Type string · GET query or POST JSON

  • Minimum characters: 1
  • Maximum characters: 8
  • Pattern: ^[0-9]{1,8}$

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, products, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "search_metadata": {
    "retailer": "Whole Foods",
    "total_time_taken": 0.362,
    "store_id": "10233",
    "postal_code": "01801-6043",
    "store_name": "Woburn"
  },
  "search_parameters": {
    "query": "coffee",
    "page": 1,
    "store_id": "10233"
  },
  "products": [
    {
      "product_id": "b07d7853dm",
      "title": "Cycledrome Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-cycledrome-coffee-12-oz-b07d7853dm",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41lwMBWCzoL.jpg"
    },
    {
      "product_id": "b085z46snm",
      "title": "Montecarlos Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/george-howell-coffee-montecarlos-coffee-12-oz-b085z46snm",
      "brand": "George Howell Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/31ABCUFLZfL.jpg"
    },
    {
      "product_id": "b004amvdh8",
      "title": "Organic Wonder Brew Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/jims-organic-coffee-organic-wonder-brew-coffee-12-oz-b004amvdh8",
      "brand": "JIMS ORGANIC COFFEE"
    },
    {
      "product_id": "b07d775m4r",
      "title": "Steamroller Blend Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-steamroller-blend-coffee-12-oz-b07d775m4r",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41mMXnFGDyL.jpg"
    },
    {
      "product_id": "b07d7fs86h",
      "title": "Fazenda Blend Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/fazenda-coffee-roasters-fazenda-blend-coffee-12-oz-b07d7fs86h",
      "brand": "FAZENDA COFFEE ROASTERS",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41-GfGmurKL.jpg"
    },
    {
      "product_id": "b0046hcjr0",
      "title": "Organic Colombian Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/jims-organic-coffee-organic-colombian-coffee-12-oz-b0046hcjr0",
      "brand": "Jims Organic Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41hJgpO15SL.jpg"
    },
    {
      "product_id": "b00a282zee",
      "title": "Organic Ground Hazelnut Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/jims-organic-coffee-organic-ground-hazelnut-coffee-12-oz-b00a282zee",
      "brand": "Jims Organic Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41zPJLuNS0L.jpg"
    },
    {
      "product_id": "b00nbkylba",
      "title": "Cold Brew Coffee, 10.5 FZ",
      "url": "https://www.wholefoodsmarket.com/product/stumptown-coffee-roasters-cold-brew-coffee-105-fz-b00nbkylba",
      "brand": "STUMPTOWN COFFEE ROASTERS",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41kcmiz--DL.jpg"
    },
    {
      "product_id": "b0dvm1q7j8",
      "title": "Organic Smooth Black Coffee, 42 FZ",
      "url": "https://www.wholefoodsmarket.com/product/equator-coffees-organic-smooth-black-coffee-42-fz-b0dvm1q7j8",
      "brand": "Equator Coffees",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/31kbxVwHFDL.jpg"
    },
    {
      "product_id": "b0djtfvf7l",
      "title": "Black Sport Coffee, 11 FZ",
      "url": "https://www.wholefoodsmarket.com/product/throne-sport-coffee-black-sport-coffee-11-fz-b0djtfvf7l",
      "brand": "Throne Sport Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/31ComLc2qpL.jpg"
    },
    {
      "product_id": "b07d6vf5vg",
      "title": "Dark Roast Of The Decade Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-dark-roast-of-the-decade-coffee-12-oz-b07d6vf5vg",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/412GQ3kdfSL.jpg"
    },
    {
      "product_id": "b07d77vcg2",
      "title": "Cycledrome Blend Decaf Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-cycledrome-blend-decaf-coffee-12-oz-b07d77vcg2",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41uA7XUgiML.jpg"
    },
    {
      "product_id": "b004bdq99i",
      "title": "Organic Witches Brew Coffee, 11 OZ",
      "url": "https://www.wholefoodsmarket.com/product/jims-organic-coffee-organic-witches-brew-coffee-11-oz-b004bdq99i",
      "brand": "JIMS ORGANIC COFFEE",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41lCpn9jQIL.jpg"
    },
    {
      "product_id": "b00jdsnnc2",
      "title": "Costa Rica Tarrazu Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/fazenda-coffee-roasters-costa-rica-tarrazu-coffee-12-oz-b00jdsnnc2",
      "brand": "Fazenda Coffee Roasters",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41lV8xCvpvL.jpg"
    },
    {
      "product_id": "b07fz7xstb",
      "title": "Guatemala Whole Bean Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/george-howell-coffee-guatemala-whole-bean-coffee-12-oz-b07fz7xstb",
      "brand": "George Howell Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/31-YmRaQ-yL.jpg"
    },
    {
      "product_id": "b07d7h6l1n",
      "title": "Natural Misty Valley Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-natural-misty-valley-coffee-12-oz-b07d7h6l1n",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41NPFNKccJL.jpg"
    },
    {
      "product_id": "b07c2wy1x4",
      "title": "Organic Double Chocolate Ground Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/jims-organic-coffee-organic-double-chocolate-ground-coffee-12-oz-b07c2wy1x4",
      "brand": "JIMS ORGANIC COFFEE",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41lRXFyKHoL.jpg"
    },
    {
      "product_id": "b00jdsug40",
      "title": "Ethiopia Light Roast Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/fazenda-coffee-roasters-ethiopia-light-roast-coffee-12-oz-b00jdsug40",
      "brand": "FAZENDA COFFEE ROASTERS",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41o30U1K7SL.jpg"
    },
    {
      "product_id": "b00jdsp2h6",
      "title": "Guatemala Finca Valparaiso Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/fazenda-coffee-roasters-guatemala-finca-valparaiso-coffee-12-oz-b00jdsp2h6",
      "brand": "Fazenda Coffee Roasters",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41rtn60u9lL.jpg"
    },
    {
      "product_id": "b07dkkcp14",
      "title": "Organic Salonika Blend Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-organic-salonika-blend-coffee-12-oz-b07dkkcp14",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41CgOwijLqL.jpg"
    },
    {
      "product_id": "b07d77l966",
      "title": "Organic Kilimanjaro Blend Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-organic-kilimanjaro-blend-coffee-12-oz-b07d77l966",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41OhgNz0xhL.jpg"
    },
    {
      "product_id": "b07d7g65f5",
      "title": "Organic Ground French Vanilla Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/jims-organic-coffee-organic-ground-french-vanilla-coffee-12-oz-b07d7g65f5",
      "brand": "JIMS ORGANIC COFFEE",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/410nEpXOZkL.jpg"
    },
    {
      "product_id": "b00jdsvnii",
      "title": "Dark French Roast Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/fazenda-coffee-roasters-dark-french-roast-coffee-12-oz-b00jdsvnii",
      "brand": "FAZENDA COFFEE ROASTERS",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/41CE-AIbSgL.jpg"
    },
    {
      "product_id": "b07d77mgz6",
      "title": "Organic Cafe Marika Coffee, 12 OZ",
      "url": "https://www.wholefoodsmarket.com/product/new-harvest-coffee-organic-cafe-marika-coffee-12-oz-b07d77mgz6",
      "brand": "New Harvest Coffee",
      "image": "https://m.media-amazon.com/images/S/assets.wholefoodsmarket.com/PIE/product/411C2Ld3ufL.jpg"
    }
  ],
  "pagination": {
    "current": 1,
    "next_page": 2,
    "total_results": 325
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Whole Foods APIs