# Walmart Products By Category > Walmart Products By Category is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14). Fetches paginated, sorted, and filtered product listings from a specific Walmart category on walmart.com or walmart.ca. ## Facts - Endpoint: GET https://agents.openwebninja.com/real-time-walmart-data/products-by-category?utm_source=zero.xyz - Price: price unknown - Payment: MPP - Status: unknown - Last checked: 2026-10-14 - Activations on Zero: 0 - Provider: agents.openwebninja.com - Website: https://agents.openwebninja.com - Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-walmart-products-by-category-4c0026ee - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b_6jBdNqAB2zzz1GmG0AY Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-openwebninja-com-walmart-products-by-category-4c0026ee ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works Get products from a specific Walmart category with pagination, sorting, and filtering options. ## Output 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. ## Request schema (JSON Schema) ```json { "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." } } } ``` ## Response schema (JSON Schema) ```json { "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 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-walmart-products-by-category-4c0026ee/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)