{"id":"0f0af915-be8d-4993-b785-a2ed9308d984","slug":"walmart-com-api","name":"walmart.com API","description":"walmart.com API","front_facing_description":"Retrieve product data from Walmart.com including pricing, descriptions, availability, reviews, and category listings. Access real-time product information to search by keyword, look up items by ID or URL, and browse department categories.","source_url":"https://walmart.com","is_authenticated":false,"canonical_scraper_id":"17a61761-c01e-4c8c-8a28-89538156d89e","apis":[{"method":"GET","endpoint_name":"search_products","description":"Full-text search over Walmart product catalog. Returns paginated product summaries with price, rating, and availability badges. Supports sorting and facet filtering. Each ProductSummary can be drilled into via get_product_details for full specifications.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination","default":1,"domain":{"kind":"open","generator":{"type":"static","value":1}}},"sort":{"type":"string","required":false,"description":"Sort order for results","enum":"Sort","domain":{"kind":"enum","values":["best_match","price_low","price_high"],"generator":{"type":"enum_pick","strategy":"first"}}},"query":{"type":"string","required":true,"description":"Search keyword (e.g. 'laptop', 'wireless headphones')","domain":{"kind":"open","generator":{"type":"static","value":"laptop"}}},"filters":{"type":"string","required":false,"description":"Facet filter string to narrow results (e.g. 'brand:Samsung')","domain":{"kind":"open","generator":{"type":"static","value":""}}}},"return_schema":{"type":"object","fields":{"items":"array of product summary objects with id, us_item_id, name, price, rating, review_count, image, url, badge, is_sponsored","facets":"array of available filter facets","total_pages":"integer total number of pages","current_page":"integer current page number or null","total_results":"integer total number of matching products"},"sample":{"data":{"items":[{"id":"24H72HS7PA9J","url":"https://www.walmart.com/ip/example/19075520026","name":"Lenovo IdeaPad Slim 3x 15.3\" Laptop","badge":"","image":"https://i5.walmartimages.com/seo/example.jpeg","price":449,"rating":4.5,"us_item_id":"19075520026","is_sponsored":true,"review_count":119}],"facets":[],"total_pages":14,"current_page":null,"total_results":67},"status":"success"}},"initiates_session":false,"price":3,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.items","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_product_details","description":"Retrieve full product detail for a single Walmart item including price, brand, description, specifications, images, variants, fulfillment options, and seller. Provide either product_id (usItemId) or a full Walmart product URL; at least one is required.","input_params":{"url":{"type":"string","required":false,"description":"Full Walmart product URL (alternative to product_id). Either product_id or url must be provided.","domain":{"kind":"open","generator":{"type":"static","value":""}}},"product_id":{"type":"string","required":false,"description":"Walmart product/item ID (usItemId). Either product_id or url must be provided.","domain":{"kind":"derived","generator":{"path":"$.data.items[0].us_item_id","type":"derived","from_endpoint":"search_products"}}}},"return_schema":{"type":"object","fields":{"id":"string internal product ID","name":"string product name","brand":"string brand name","price":"number current price","images":"array of image URL strings","rating":"number average rating or null","seller":"object with seller name and id, or null","currency":"string currency code (e.g. USD)","variants":"array of variant criteria objects","us_item_id":"string Walmart usItemId","description":"string product description","fulfillment":"array of fulfillment option objects","availability":"string availability status (e.g. IN_STOCK)","review_count":"integer number of reviews or null","original_price":"number original/was price or null","specifications":"array of objects with name and value","reviews_summary":"object with review summary data or null"},"sample":{"data":{"id":"4D5SG689UM1X","name":"Acer Chromebook 315 15.6 inch Laptop","brand":"Acer","price":199,"images":["https://i5.walmartimages.com/seo/example.jpeg"],"rating":null,"seller":{"id":"F55CDC31AB754BB68FE0B39041159D63","name":"Walmart.com"},"currency":"USD","variants":[],"us_item_id":"3193557250","description":"The Acer Chromebook 315 features a 15.6\" anti-glare screen.","fulfillment":[{"type":"SHIPPING","availabilityStatus":"IN_STOCK"}],"availability":"IN_STOCK","review_count":null,"original_price":null,"specifications":[{"name":"Battery life","value":"10 h"}],"reviews_summary":{"summary":"Customers are pleased with the laptop.","summaryTitle":"Affordable laptop"}},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.us_item_id","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_product_reviews","description":"Retrieve paginated customer reviews for a specific Walmart product. Returns individual reviews with ratings, text, reviewer info, and pagination metadata (10 reviews per page; pagination.next is null on the last page). Use product_id (usItemId) from search_products or get_product_details. Each call makes two round trips: the product page is loaded first, then the reviews page, so an unknown product_id is rejected as not found before any reviews are requested. Page defaults to 1 when omitted.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for review pagination","default":1,"domain":{"kind":"open","generator":{"type":"static","value":1}}},"product_id":{"type":"string","required":true,"description":"Walmart product/item ID (usItemId)","domain":{"kind":"derived","generator":{"path":"$.data.items[0].us_item_id","type":"derived","from_endpoint":"search_products"}}}},"return_schema":{"type":"object","fields":{"reviews":"array of review objects with rating, reviewText, userNickname, reviewSubmissionTime, and other fields","pagination":"object with page navigation info including currentSpan, next, previous, pages, and total","product_id":"string the requested product ID","total_reviews":"integer total number of reviews","average_rating":"number average overall rating"},"sample":{"data":{"reviews":[{"rating":5,"reviewText":"Great laptop for browsing.","reviewTitle":"Fast, simple, and exactly what I needed","userNickname":"Shane","reviewSubmissionTime":"3/29/2026"}],"pagination":{"next":{"num":null,"url":"sort=relevancy&page=2"},"pages":[{"num":1,"url":"sort=relevancy&page=1","active":true}],"total":4058,"previous":null,"currentSpan":"1-10"},"product_id":"3193557250","total_reviews":19295,"average_rating":4.3},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.product_id","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_category_listings","description":"Browse products within a specific Walmart category or department. Returns paginated product listings identical in shape to search_products. Category IDs are numeric identifiers from Walmart's taxonomy (e.g. '976759' for food, '1115193' for electronics).","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination","default":1,"domain":{"kind":"open","generator":{"type":"static","value":1}}},"slug":{"type":"string","required":false,"description":"Category URL slug used in the browse URL path","domain":{"kind":"open","generator":{"type":"static","value":"food"}}},"filters":{"type":"string","required":false,"description":"Facet filter string to narrow results","domain":{"kind":"open","generator":{"type":"static","value":""}}},"category_id":{"type":"string","required":true,"description":"Walmart category ID (e.g. '976759' for food, '1115193' for electronics)","domain":{"kind":"open","generator":{"type":"static","value":"976759"}}}},"return_schema":{"type":"object","fields":{"items":"array of product summary objects with id, us_item_id, name, price, rating, review_count, image, url, badge, is_sponsored","facets":"array of available filter facets","total_pages":"integer total number of pages","current_page":"integer current page number or null","total_results":"integer total number of products in category"},"sample":{"data":{"items":[{"id":"3DEPG6O77D9W","url":"https://www.walmart.com/ip/example/16576201491","name":"Galil Thin All-Natural Corn Cakes","badge":"","image":"https://i5.walmartimages.com/seo/example.png","price":10,"rating":4.4,"us_item_id":"16576201491","is_sponsored":true,"review_count":52}],"facets":[],"total_pages":25,"current_page":null,"total_results":47},"status":"success"}},"initiates_session":false,"price":5,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.items","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_store_locations","description":"Retrieve all Walmart store locations in a US state. Returns store name, type, full address, phone number, weekly operating hours, and available services/departments. Fetches data from Walmart's store directory by iterating city pages for the given state; response time scales with the number of cities in the state.","input_params":{"state":{"type":"string","required":true,"description":"2-letter US state abbreviation (e.g. 'TX', 'CA', 'VT')","domain":{"kind":"open","generator":{"type":"static","value":"VT"}}}},"return_schema":{"type":"object","fields":{"state":"string - the queried state abbreviation","stores":"array of store objects with store_id, name, store_type, address, city, state, zip_code, phone, hours, open_24_hours, services","total_stores":"integer - total number of stores found in the state"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.stores","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"search_grocery_products","description":"Search Walmart grocery products by keyword, scoped to a specific Walmart store for store-specific availability and pricing. Provide either zip_code (to let Walmart assign the nearest store) or store_id (to lock results to that exact physical store). When store_id is provided, results include only products from that store; if the store cannot be matched, an empty product list is returned rather than falling back to another store. Returns paginated product listings with name, brand, package size, current price, price per unit, item ID, product URL, and a store object identifying the specific Walmart physical store whose inventory and pricing was used. Each page returns up to ~40 products.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination","default":1,"domain":{"kind":"open","generator":{"type":"static","value":1}}},"query":{"type":"string","required":true,"description":"Grocery search keyword (e.g. 'boneless skinless chicken breast', 'organic milk')","domain":{"kind":"open","generator":{"type":"static","value":"boneless skinless chicken breast"}}},"store_id":{"type":"string","required":false,"description":"Walmart store ID (e.g. '3081') to lock search results to a specific physical store. Obtainable from get_store_locations. When provided, only products priced and available at that exact store are returned; if the store cannot serve results, an empty list is returned. Either store_id or zip_code must be provided."},"zip_code":{"type":"string","required":false,"description":"5-digit US ZIP code for store-specific results (e.g. '27401'). Either zip_code or store_id must be provided.","domain":{"kind":"open","generator":{"type":"static","value":"27401"}}}},"return_schema":{"type":"object","fields":{"query":"string - the search keyword used","products":"array of grocery product objects with name, brand, package_size, price, price_per_unit, item_id, url, protein_per_serving, serving_size, servings_per_container, and store object","zip_code":"string - the ZIP code used","total_pages":"integer or null - total number of pages","current_page":"integer or null - current page number","total_results":"integer - total number of matching products"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.products","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"search_products":{"page":"1","sort":"best_match","query":"laptop"},"get_product_details":{"product_id":"18638703162"},"get_product_reviews":{"page":"1","product_id":"18638703162"},"get_store_locations":{"state":"VT"},"get_category_listings":{"page":"1","slug":"food","category_id":"976759"},"search_grocery_products":{"page":"1","query":"boneless skinless chicken breast","zip_code":"27401"}},"prefill_inputs":{"search_products":{"page":"1","sort":"best_match","query":"laptop","filters":""},"get_product_details":{"url":""},"get_product_reviews":{"page":"1"},"get_category_listings":{"page":"1","slug":"food","filters":"","category_id":"976759"},"get_store_locations":{"state":"VT"},"search_grocery_products":{"page":"1","query":"boneless skinless chicken breast","zip_code":"27401"}},"last_verified_at":"2026-11-01T05:40:03.056166+00:00","endpoint_health":[{"endpoint_name":"search_grocery_products","status":"healthy","last_checked_at":"2026-11-01T05:40:03.056166+00:00","last_verified_at":"2026-11-01T05:40:03.056166+00:00","recent_runs":[{"at":"2026-10-27T19:03:53.422339+00:00","status":"healthy"},{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T07:01:52.868244+00:00","status":"ambiguous"},{"at":"2026-10-26T05:03:52.899000+00:00","status":"ambiguous"},{"at":"2026-10-26T03:04:25.206817+00:00","status":"ambiguous"}]},{"endpoint_name":"get_product_reviews","status":"healthy","last_checked_at":"2026-10-27T19:03:53.422339+00:00","last_verified_at":"2026-10-27T19:03:53.422339+00:00","recent_runs":[{"at":"2026-10-27T19:03:53.422339+00:00","status":"healthy"},{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T07:01:52.868244+00:00","status":"blocked"},{"at":"2026-10-26T05:03:52.899000+00:00","status":"blocked"},{"at":"2026-10-26T03:04:25.206817+00:00","status":"blocked"}]},{"endpoint_name":"get_category_listings","status":"healthy","last_checked_at":"2026-10-27T19:03:53.422339+00:00","last_verified_at":"2026-10-27T19:03:53.422339+00:00","recent_runs":[{"at":"2026-10-27T19:03:53.422339+00:00","status":"healthy"},{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T07:01:52.868244+00:00","status":"ambiguous"},{"at":"2026-10-26T05:03:52.899000+00:00","status":"ambiguous"},{"at":"2026-10-26T03:04:25.206817+00:00","status":"ambiguous"}]},{"endpoint_name":"get_product_details","status":"healthy","last_checked_at":"2026-10-31T18:23:07.420674+00:00","last_verified_at":"2026-10-31T18:23:07.420674+00:00","recent_runs":[{"at":"2026-10-27T19:03:53.422339+00:00","status":"healthy"},{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T07:01:52.868244+00:00","status":"blocked"},{"at":"2026-10-26T05:03:52.899000+00:00","status":"blocked"},{"at":"2026-10-26T03:04:25.206817+00:00","status":"blocked"}]},{"endpoint_name":"get_store_locations","status":"healthy","last_checked_at":"2026-11-01T04:51:12.939444+00:00","last_verified_at":"2026-11-01T04:51:12.939444+00:00","recent_runs":[{"at":"2026-10-27T19:03:53.422339+00:00","status":"healthy"},{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T07:01:52.868244+00:00","status":"ambiguous"},{"at":"2026-10-26T05:03:52.899000+00:00","status":"ambiguous"},{"at":"2026-10-26T03:04:25.206817+00:00","status":"ambiguous"}]},{"endpoint_name":"search_products","status":"healthy","last_checked_at":"2026-10-31T18:08:39.917411+00:00","last_verified_at":"2026-10-31T18:08:39.917411+00:00","recent_runs":[{"at":"2026-10-27T19:03:53.422339+00:00","status":"healthy"},{"at":"2026-10-26T10:01:52.923879+00:00","status":"healthy"},{"at":"2026-10-26T07:01:52.868244+00:00","status":"ambiguous"},{"at":"2026-10-26T05:03:52.899000+00:00","status":"ambiguous"},{"at":"2026-10-26T03:04:25.206817+00:00","status":"ambiguous"}]}],"sdk_usage_example":null,"sdk_delivery_state":"absent","summary":"Search products, get product details, reviews, and browse categories on Walmart.com","updated_at":"2026-09-16T22:24:07.281228+00:00","user_variants":[],"latest_version":17,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Walmart does offer an official API through the Walmart Open API program (developer.walmart.com), primarily targeting marketplace sellers for order and inventory management. It does not expose consumer-facing product search, reviews, or store directory data in the same form this API covers.","q":"Does Walmart have an official developer API?"},{"a":"The endpoint returns `brand`, `seller` (name and id), `currency`, an `images` array of full-resolution URLs, a `variants` array of variant criteria objects, and the `us_item_id`. The `rating` field is nullable — some items have no reviews yet.","q":"What does `get_product_details` return beyond price and name?"},{"a":"`search_grocery_products` requires a `zip_code` parameter to scope results to a specific store's inventory and pricing. It also returns grocery-specific fields like `package_size`, `price_per_unit`, `protein_per_serving`, and `serving` that are absent from the general `search_products` response.","q":"How does grocery search differ from the general product search?"},{"a":"Not currently. The API returns standard retail pricing from `price` fields in product and grocery endpoints but does not expose Walmart+ member pricing, savings badges, or subscription plan data. You can fork the API on Parse and revise it to add an endpoint targeting those fields if they become accessible.","q":"Are Walmart+ membership prices or subscription details available?"},{"a":"The endpoint accepts 2-letter US state abbreviations and is documented for US states. Coverage for territories like Puerto Rico is not confirmed. For states with many cities the response time is longer because results are gathered city by city — plan timeouts accordingly.","q":"Does `get_store_locations` cover Puerto Rico or other US territories?"}],"keywords":["walmart product search API","walmart price tracking API","walmart product details API","walmart customer reviews API","walmart category listings API","walmart store locations API","walmart grocery search by zip code","walmart us_item_id lookup","walmart seller data API","walmart product variants API","walmart ecommerce data API","walmart price per unit grocery API","walmart sponsored products API","walmart department browse API"],"use_cases":["Track Walmart price changes on specific items using `get_product_details` and the `price` field","Compare sponsored vs. organic product placement in search results via the `is_sponsored` flag in `search_products`","Aggregate customer sentiment by pulling `reviewText` and `rating` fields from `get_product_reviews` across multiple products","Build a store locator showing hours, services, and phone numbers using `get_store_locations` filtered by state","Monitor in-store grocery pricing by ZIP code for a specific keyword using `search_grocery_products` and `price_per_unit`","Enumerate all products in an electronics or food department using `get_category_listings` with known category IDs","Identify seller diversity on Walmart marketplace by extracting the `seller` object from `get_product_details` across a product set"],"meta_title":"Walmart.com API — Products, Reviews & Stores","generated_at":"2026-08-12T14:14:48.752771+00:00","lead_paragraph":"This API gives programmatic access to Walmart.com across 6 endpoints, covering product search, full item details, customer reviews, category browsing, grocery search, and store directory data. The `search_products` endpoint returns paginated product summaries including price, rating, review count, and sponsored status, while `get_product_details` exposes brand, seller identity, variant criteria, and the full image array for any individual item.","schema_version":2,"meta_description":"Search Walmart products, retrieve pricing and specs, read customer reviews, browse categories, and look up store locations via a single REST API.","primary_category":"ecommerce","long_description_md":"## Product Search and Detail\n\n`search_products` accepts a required `query` string plus optional `sort`, `page`, and `filters` parameters (e.g. `brand:Samsung`). Each result in the `items` array includes `us_item_id`, `price`, `rating`, `review_count`, `badge`, and `is_sponsored`. The `facets` array and `total_results` field let you build filter UIs or measure category depth. To go deeper on any item, pass its `us_item_id` or a full product URL to `get_product_details`, which returns `brand`, `seller` (name and id), `currency`, `images`, `variants`, and the current `price`.\n\n## Reviews and Category Data\n\n`get_product_reviews` takes a `product_id` (the `us_item_id` from search or detail) and an optional `page` number. Each entry in the `reviews` array carries `rating`, `reviewText`, `userNickname`, and `reviewSubmissionTime`. The `pagination` object includes `currentSpan`, `next`, `previous`, and `pages` fields alongside `total_reviews` and `average_rating` at the top level. `get_category_listings` mirrors the shape of `search_products` but scopes results to a Walmart category ID (e.g. `1115193` for electronics); an optional `slug` aligns the request to a specific browse URL path.\n\n## Grocery Search and Store Locations\n\n`search_grocery_products` scopes results by a required 5-digit `zip_code`, returning store-specific pricing and availability. Each product object includes `brand` (nullable), `package_size` parsed from the product name, `price`, `price_per_unit`, `protein_per_serving`, and `serving`. `get_store_locations` takes a 2-letter US state abbreviation and returns every Walmart location in that state with `store_id`, `store_type`, `address`, `phone`, `hours`, `open_24_hours`, and a `services` array. Response time for this endpoint scales with the number of cities in the state.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["reviews_ratings","food_dining","maps_geo"]},"primary_category":"ecommerce","secondary_categories":["reviews_ratings","food_dining","maps_geo"],"access_requirements":[]}