{"uid":"cap_Df2t09afnAhaJON8_C7Vf","slug":"agents-openwebninja-com-walmart-product-search-a10d3ffc","name":"Walmart Product Search","description":"Search for products on Walmart with pagination support and multiple filters and options such as sort by, price range, location, and more.","url":"https://agents.openwebninja.com/real-time-walmart-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"page":{"type":"number","default":1,"minimum":1,"description":"Page number for pagination. Default is 1."},"facet":{"type":"string","description":"Facet filter string for refining results (e.g. by brand, category). Obtained from a previous search response's facet data."},"query":{"type":"string","description":"Search query string. E.g. 'laptop', 'iphone 15', 'nike shoes'"},"state":{"type":"string","description":"US state code (e.g. 'CA', 'NY') to localize search results such as availability and shipping options."},"domain":{"enum":["us","ca"],"type":"string","default":"us","description":"Walmart domain to search. 'us' for walmart.com, 'ca' for walmart.ca. Default is 'us'."},"sort_by":{"enum":["best_match","price_low","price_high","best_seller","top_rated"],"type":"string","default":"best_match","description":"Sort results by the given criteria. Accepts aliases: price_low, price_high, best_seller, top_rated. Default is best_match."},"store_id":{"type":"string","description":"Walmart store ID to get store-specific prices and availability. Supported for domain 'ca': results are rendered for that walmart.ca store (e.g. '3148' for Lévis, QC) and the response `location` object confirms the store applied. Without it walmart.ca defaults to Mississauga Supercenter (store 1061). For domain 'us' this parameter is currently not applied to search results."},"max_price":{"type":"number","description":"Maximum price filter. Must be higher than min_price if both are specified."},"min_price":{"type":"number","description":"Minimum price filter. Must be lower than max_price if both are specified."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"location":{"type":"object","nullable":true,"properties":{"city":{"type":"string","nullable":true,"description":"City associated with the location. null on walmart.ca when store_id is set."},"state":{"type":"string","nullable":true,"description":"State or province code. null on walmart.ca when store_id is set."},"store_id":{"type":"string","description":"Walmart store ID the prices were rendered for."},"postal_code":{"type":"string","nullable":true,"description":"Postal / ZIP code associated with the location. null on walmart.ca when store_id is set (Walmart does not return the selected store's address; use store_id)."}},"description":"The store location Walmart resolved this response for. Use it to verify which store the prices belong to. With no store_id, walmart.ca defaults to Mississauga Supercenter (store 1061) and walmart.com to a store near the request's exit location."},"products":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"The product page URL."},"brand":{"type":"string","description":"The product brand when available, otherwise null."},"image":{"type":"string","description":"The main image URL for the product."},"price":{"type":"number","description":"The current selling price of the product."},"title":{"type":"string","description":"The product title."},"pickup":{"type":"boolean","description":"Whether pickup is available for the product."},"rating":{"type":"number","description":"The average product rating."},"seller":{"type":"string","description":"The seller name for the product."},"currency":{"type":"string","description":"The currency code for the displayed prices."},"position":{"type":"integer","description":"The position of the product in the returned list."},"preorder":{"type":"boolean","description":"Whether the product is available for pre-order."},"shipping":{"type":"boolean","description":"Whether shipping is available for the product."},"max_price":{"type":"string","description":"The maximum price when a price range applies, otherwise null."},"min_price":{"type":"string","description":"The minimum price when a price range applies, otherwise null."},"seller_id":{"type":"string","description":"The identifier of the seller."},"sponsored":{"type":"boolean","description":"Whether the product listing is sponsored."},"thumbnail":{"type":"string","description":"A thumbnail image URL for the product."},"list_price":{"type":"integer","description":"The original or list price of the product."},"product_id":{"type":"string","description":"The product identifier from the source."},"us_item_id":{"type":"string","description":"The US item identifier for the product."},"badge_flags":{"type":"array","items":{"type":"string"},"description":"A list of badge flags applied to the product."},"best_seller":{"type":"boolean","description":"Whether the product is marked as a best seller."},"description":{"type":"string","description":"A short description of the product."},"availability":{"type":"string","description":"The availability status text for the product."},"out_of_stock":{"type":"boolean","description":"Whether the product is currently out of stock."},"review_count":{"type":"integer","description":"The number of reviews for the product."},"free_shipping":{"type":"boolean","description":"Whether free shipping is available."},"price_display":{"type":"string","description":"A formatted string representation of the price."},"primary_offer":{"type":"object","properties":{"offer_id":{"type":"string","description":"The identifier for the primary offer."},"min_price":{"type":"string","description":"The minimum price for the offer when applicable, otherwise null."},"offer_price":{"type":"number","description":"The price of the primary offer."}}},"shipping_days":{"type":"string","description":"The estimated shipping time in days when available, otherwise null."},"savings_amount":{"type":"integer","description":"The amount saved compared to list price."},"currency_symbol":{"type":"string","description":"The currency symbol used for display."},"two_day_shipping":{"type":"boolean","description":"Whether two-day shipping is available."},"delivery_from_store":{"type":"boolean","description":"Whether delivery from a local store is available."},"price_per_unit_type":{"type":"string","description":"The per-unit price type (e.g., oz, lb) when available, otherwise null."},"price_per_unit_amount":{"type":"string","description":"The per-unit price amount when available, otherwise null."},"multiple_options_available":{"type":"boolean","description":"Whether multiple variants/options are available for the product."},"free_shipping_with_walmart_plus":{"type":"boolean","description":"Whether free shipping is available with Walmart+."}}},"description":"The list of product results for the current page."},"total_pages":{"type":"integer","description":"The total number of pages available for the current query."},"total_results":{"type":"string","description":"The total number of matching results when available, otherwise null."}}},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"page":{"type":"integer","description":"The page number of results to return."},"query":{"type":"string","description":"The search query used to retrieve products."},"domain":{"type":"string","description":"The store or domain used as the data source for results."},"sort_by":{"type":"string","description":"The sorting method used for the product results."}}},"request_id":{"type":"string","description":"A unique identifier for this request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_jRBnJs7Ztw5yOGyP5ElKc","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Search Walmart's product catalog (US or Canada) with filters for price range, sort order, location, store, and facets, returning paginated product listings with prices and availability.","exampleAgentPrompt":"Search Walmart US for 'wireless headphones' sorted by top_rated, priced between $30 and $150, and show me the first page of results.","exampleUseCases":[{"title":"Budget gift shopping on Walmart","prompt":"Find me top-rated toys on Walmart under $25 sorted by best_seller — I'm shopping for a gift and want to see what's popular right now."},{"title":"Walmart Canada store-specific search","prompt":"Search Walmart Canada for 'winter boots' at store 3148 in Lévis, QC, sorted by price low to high, and show me page 1 of results."},{"title":"Price comparison research for electronics","prompt":"Look up 'iPhone 15 case' on Walmart in California, sorted by lowest price, with a max price of $20 — I want to compare what's available and in stock."}],"resultDescription":"Returns a paginated list of Walmart products matching the query, each with title, price, currency, brand, seller, rating, product URL, image URL, shipping and pickup availability, and pre-order status. Also returns a location object confirming which store the prices were rendered for, and facet data for further filtering.","failureModes":["Missing required 'query' parameter returns a 400 validation error","Invalid store_id may cause Walmart to default to a different store without warning","Price filters where min_price >= max_price will be rejected","Unavailable products or out-of-stock items may still appear in results","store_id is currently ignored for the 'us' domain","Facet strings must be obtained from a prior search response; invalid facets silently drop the filter","Rate limits or payment failures return 402 or 429 errors from the proxy"],"whenToPreferThis":"Use this endpoint when you need real-time Walmart product search results with flexible filtering by price, sort order, store location, or category facets, and need to return multiple paginated results. Prefer this over Amazon or eBay search endpoints when the user specifically wants Walmart pricing or availability, or when US/Canada store-level localization is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:30:03.022Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-walmart-product-search-a10d3ffc"}