# 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. - Page: https://fous.com/methods/walmart.com/search-products - Method: `walmart.com/search_products`, version 1 - Website: walmart.com - Returns: product name, price, was price, rating, review count, seller, pickup and delivery availability, sponsored flag, photo, link, item id - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `page` | integer | no | `2` | Results page, for example 2. Default 1. | | `sort` | string | no | `"price_low_to_high"` | Sort results, for example price_low_to_high. One of "best_match", "price_low_to_high", "price_high_to_low", "best_seller", "top_rated". Default "best_match". | | `query` | string | yes | `"coffee maker"` | Product search words, for example TV stand. | | `max_price` | number | no | `100` | Maximum price in USD, for example 200. | | `min_price` | number | no | | Minimum price in USD, for example 50. | | `max_results` | integer | no | `25` | Maximum products returned, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "page": 2, "sort": "price_low_to_high", "query": "coffee maker", "max_price": 100, "max_results": 25 } ``` Its output: ```json { "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" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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? ## Input schema ```json { "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 ```json { "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 } ``` ## See more - [Walmart API: Get product](https://fous.com/methods/walmart.com/get-product.md): Gets details, price and availability for a Walmart product by name or product link, using Walmart's default location. - [Amazon API: Search products](https://fous.com/methods/amazon.com/search-products.md): Searches 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. - [Best Buy API: Search products](https://fous.com/methods/bestbuy.com/search-products.md): Searches 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. - [Macy's API: Search products](https://fous.com/methods/macys.com/search-products.md): Searches 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. - [Flipkart API: Search products](https://fous.com/methods/flipkart.com/search-products.md): Searches Flipkart products by keyword, with an optional price range and sort order. Returns current listings in site order. - [Target API: Search products](https://fous.com/methods/target.com/search-products.md): Searches 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. - [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches 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. - [Kohl's API: Search products](https://fous.com/methods/kohls.com/search-products.md): Searches Kohl's products in site order and returns prices, offers, ratings and links for each result. - [All Walmart methods](https://fous.com/methods/walmart.com.md)