{"uid":"cap_b_6jBdNqAB2zzz1GmG0AY","slug":"agents-openwebninja-com-walmart-products-by-category-4c0026ee","name":"Walmart Products By Category","description":"Get products from a specific Walmart category with pagination, sorting, and filtering options.","url":"https://agents.openwebninja.com/real-time-walmart-data/products-by-category?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["category_id"],"properties":{"zip":{"type":"string","description":"ZIP/postal code to localize results."},"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)."},"state":{"type":"string","description":"US state code (e.g. 'CA', 'NY') to localize results."},"domain":{"enum":["us","ca"],"type":"string","default":"us","description":"Walmart domain. '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."},"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."},"category_id":{"type":"string","description":"Walmart category ID. E.g. '3944' for Electronics, '976759' for Cell Phones. Found in product details category URLs or Walmart's site navigation."}}},"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":"number","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":"object","properties":{"key":{"type":"string","description":"The badge flag key."},"text":{"type":"string","description":"The display text for the badge flag."}}},"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 product description when available, otherwise null."},"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":"number","description":"The amount saved compared to list price when available."},"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 category."},"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."},"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."},"category_id":{"type":"string","description":"The category identifier used to retrieve products."}}},"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_Mzbo0qNPdfphFxsM_253m","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":"Fetches paginated, sorted, and filtered product listings from a specific Walmart category on walmart.com or walmart.ca.","exampleAgentPrompt":"Show me the top-rated Walmart electronics (category 3944) priced between $50 and $300, sorted by top_rated, on page 1 for the US site.","exampleUseCases":[{"title":"Price comparison shopping for TVs","prompt":"Pull up all Walmart TVs in category 1060825 sorted by lowest price, with a max price of $800, on the US site — give me the first page of results with titles, prices, and product URLs."},{"title":"Walmart Canada store-specific inventory","prompt":"Get me page 1 of Walmart Canada's cell phone category (976759) sorted by best sellers, using store 3148 in Lévis, QC, so I can see the local pricing."},{"title":"Finding best-rated budget kitchen appliances","prompt":"Show me the best-rated kitchen appliances on Walmart (category 1072864) priced between $20 and $150, sorted by top_rated, on page 2 of results."}],"resultDescription":"Returns an array of product objects including title, price, currency, brand, seller, rating, review count, image URL, product page URL, and availability flags for pickup, shipping, and pre-order. Also returns a location object confirming which Walmart store/region the prices were rendered for, plus pagination metadata.","failureModes":["Invalid or unknown category_id returns empty product array","min_price higher than max_price causes a validation error","Requesting a page beyond available results returns an empty list","store_id for domain 'us' is accepted but not applied — prices may not reflect store-specific availability","Unsupported sort_by value may fall back to best_match without warning","Network or proxy timeout if Walmart's servers are slow"],"whenToPreferThis":"Use this endpoint when you need to browse or compare products across an entire Walmart category — especially when you want pagination, sorting (price, rating, bestseller), price range filtering, or localized store/region pricing. Prefer it over a product search endpoint when you already know the category ID and want to explore the full assortment rather than search by keyword. Also preferred when you need Walmart Canada (walmart.ca) product listings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:03.720Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-walmart-products-by-category-4c0026ee"}