Walmart API: Search products
Searches Walmart products by keywords with optional sort and price range, returning prices, ratings, sellers and availability in Walmart's order. Uses Walmart's default location (no ZIP-based pricing).
Unofficial. Not affiliated with or endorsed by Walmart.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Page optional
page Results page, for example 2.
2
Whole number 1 or more. Default
1.- Sort optional
sort Sort results, for example price_low_to_high.
price_low_to_high
One of
best_match,price_low_to_high,price_high_to_low,best_seller,top_rated. Defaultbest_match.- Query, required
query Product search words, for example TV stand.
coffee maker
- Max Price optional
max_price Maximum price in USD, for example 200.
100
Number 0 or more.
- Min Price optional
min_price Minimum price in USD, for example 50.
Not set
Number 0 or more.
- Max Results optional
max_results Maximum products returned, for example 20.
25
Whole number from 1 to 60. Default
20.
Input as JSON
{ "page": 2, "sort": "price_low_to_high", "query": "coffee maker", "max_price": 100, "max_results": 25}Output
{ "products": [ { "price": 21.49, "currency": "USD", "sponsored": false, "was_price": null, "photo_link": "https://i5.walmartimages.com/seo/Brentwood-4-Cup-Coffee-Maker-Black_d4608a91-fc24-4dbb-ac26-c9e221821360.c0f6f895b9a5a9a21973ca5320949d2e.jpeg" , "seller_name": "Walmart.com", "star_rating": 4.4, "product_link": "https://www.walmart.com/ip/Brentwood-4-Cup-Coffee-Maker-Black/50991021?classType=REGULAR" , "product_name": "Brentwood 4 Cup Coffee Maker - Black", "review_count": 71, "walmart_item_id": "50991021", "pickup_availability": null, "delivery_availability": "Delivery by 2026-10-01" }, { "price": 21.87, "currency": "USD", "sponsored": false, "was_price": 25, "photo_link": "https://i5.walmartimages.com/seo/Gourmia-Iced-Coffee-Maker-with-25-fl-oz-Reusable-Tumbler-Blue_43c57ff3-66e7-4823-87cf-6c5ce9e10492.b7e84befed213ca1853dcab9879bd3e6.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF" , "seller_name": "Mercamur Products LLC", "star_rating": 3.9, "product_link": "https://www.walmart.com/ip/Gourmia-Iced-Coffee-Maker-with-25-fl-oz-Reusable-Tumbler-Blue/478186917?classType=VARIANT&athbdg=L1105" , "product_name": "Gourmia Iced Coffee Maker with 25 fl oz. Reusable Tumbler, Blue", "review_count": 545, "walmart_item_id": "478186917", "pickup_availability": null, "delivery_availability": "Delivery by 2026-10-06" }, { "price": 21.99, "currency": "USD", "sponsored": false, "was_price": 36.31, "photo_link": "https://i5.walmartimages.com/seo/Gourmia-5-Cup-One-Touch-Switch-Coffee-Maker-with-Auto-Keep-Warm-Black_240d0726-1597-43aa-88a2-28e45249e873.b66baaab5a5a6afe94a506389e12efd2.jpeg" , "seller_name": "Gourmia", "star_rating": 4.4, "product_link": "https://www.walmart.com/ip/Gourmia-5-Cup-One-Touch-Switch-Coffee-Maker-with-Auto-Keep-Warm-Black/5095233663?classType=REGULAR" , "product_name": "Gourmia 5 Cup One-Touch Coffee Maker with Auto Keep Warm", "review_count": 294, "walmart_item_id": "5095233663", "pickup_availability": null, "delivery_availability": "Delivery by 2026-09-30" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"walmart.com/search_products","input":{"page":2,"sort":"price_low_to_high","query":"coffee maker","max_price":100,"max_results":25}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "walmart.com/search_products" , "input": { "page": 2, "sort": "price_low_to_high", "query": "coffee maker", "max_price": 100, "max_results": 25 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "walmart.com/search_products" , "input": { "page": 2, "sort": "price_low_to_high", "query": "coffee maker", "max_price": 100, "max_results": 25 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run walmart.com/search_products# with {"page":2,"sort":"price_low_to_high","query":"coffee maker","max_price":100,"max_results":25}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "query" ], "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "Results page, for example 2." }, "sort": { "enum": [ "best_match", "price_low_to_high", "price_high_to_low", "best_seller", "top_rated" ], "type": "string", "default": "best_match", "description": "Sort results, for example price_low_to_high." }, "query": { "type": "string", "minLength": 1, "description": "Product search words, for example TV stand." }, "max_price": { "type": "number", "minimum": 0, "description": "Maximum price in USD, for example 200." }, "min_price": { "type": "number", "minimum": 0, "description": "Minimum price in USD, for example 50." }, "max_results": { "type": "integer", "default": 20, "maximum": 60, "minimum": 1, "description": "Maximum products returned, for example 20." } }}Output schema
{ "type": "object", "required": [ "products" ], "properties": { "products": { "type": "array", "items": { "type": "object", "required": [ "product_name", "price", "currency", "was_price", "star_rating", "review_count", "seller_name", "pickup_availability", "delivery_availability", "sponsored", "photo_link", "product_link", "walmart_item_id" ], "properties": { "price": { "type": [ "number", "null" ], "description": "Current price in USD." }, "currency": { "type": "string", "description": "Price currency code." }, "sponsored": { "type": "boolean", "description": "Whether this placement is sponsored." }, "was_price": { "type": [ "number", "null" ], "description": "Previous price in USD when reduced, otherwise null." }, "photo_link": { "type": [ "string", "null" ], "description": "Product photo link." }, "seller_name": { "type": [ "string", "null" ], "description": "Walmart.com or the marketplace seller." }, "star_rating": { "type": [ "number", "null" ], "description": "Average star rating, or null if none." }, "product_link": { "type": "string", "description": "Walmart product page link." }, "product_name": { "type": "string", "description": "Product name." }, "review_count": { "type": [ "integer", "null" ], "description": "Number of reviews, or null if none." }, "walmart_item_id": { "type": [ "string", "null" ], "description": "Walmart item ID.", "x-fous-developer": true }, "pickup_availability": { "type": [ "string", "null" ], "description": "Pickup availability, or null when not provided." }, "delivery_availability": { "type": [ "string", "null" ], "description": "Delivery or shipping availability, or null when not provided." } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
walmart.com/search_products- Returns
- product name, price, was price, rating, review count, seller, pickup and delivery availability, sponsored flag, photo, link, item id
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method walmart.com/search_products with the inputs above.
Ask your agent
- Find air fryers under $80 on Walmart, sorted by top rated, and show ratings and review counts
- Cheapest 55 inch TVs between $250 and $500 — list price, seller, and whether pickup is available
- Best-selling LEGO sets at walmart.com, give me the first 30 results with links
- Show me page 2 of results for cordless drill, sorted highest price first
- I need a queen mattress topper for $30 to $100 — which ones are on sale compared to their was price, and are any sponsored?
See more
All Walmart methodsGets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
walmart.com/get_productSearches Amazon products in a chosen country store, with price range, sort, Prime and page options. Returns the listings and prices shown to an anonymous shopper in the store's currency.
amazon.com/search_productsSearches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.
bestbuy.com/search_productsSearches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price.
macys.com/search_productsSearches Flipkart products by keyword, with an optional price range and sort order. Returns current listings in site order.
flipkart.com/search_productsSearches Target products and returns prices, ratings, photos and product links. Prices can vary by store, so you can give a ZIP code for local pricing.
target.com/search_productsSearches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
aliexpress.com/search_productsSearches Kohl's products in site order and returns prices, offers, ratings and links for each result.
kohls.com/search_products
