# Walmart Reviews ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/walmart/reviews` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/walmart-reviews | ## Description Walmart reviews by item id or URL. Returns the star breakdown, highlighted reviews, mentions, and one page of customer reviews. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/walmart/reviews' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Tajin reviews ```json { "product": { "url": "https://www.walmart.com/ip/Tajin-Clasic-Seasoning-14oz/138762768", "name": "Tajin Clasico Seasoning, 14oz", "categories": [ { "url": "https://www.walmart.com/cp/food/976759", "name": "Food" }, { "url": "https://www.walmart.com/cp/pantry/976794", "name": "Pantry" }, { "url": "https://www.walmart.com/cp/pantry-meal-essentials/2807108", "name": "Pantry meal essentials" } ] }, "ratings": [ { "count": 11, "stars": 1 }, { "count": 3, "stars": 2 }, { "count": 5, "stars": 3 }, { "count": 22, "stars": 4 }, { "count": 308, "stars": 5 } ], "reviews": [ { "text": "We ordered 5, but only delivered 4.", "rating": 5, "position": 1, "seller_name": "Walmart.com", "customer_type": [ "VerifiedPurchaser" ], "user_nickname": "Jia", "negative_feedback": 0, "positive_feedback": 0, "review_submission_time": "9/27/2025" }, { "text": "delivery was accurate! and packaged nicely!", "title": "😷😷😷☺️☺️☺️😁😁😁...thank you!", "rating": 5, "position": 2, "seller_name": "Star Sales", "customer_type": [ "VerifiedPurchaser" ], "user_nickname": "Oneitha", "negative_feedback": 0, "positive_feedback": 0, "review_submission_time": "12/13/2023" } ], "pagination": { "next": "https://www.walmart.com/reviews/product/138762768?sort=relevancy&page=2", "page": 1, "per_page": 10, "total_pages": 3, "total_results": 22 }, "total_count": 349, "top_mentions": [ { "name": "For Fruit", "count": 3 }, { "name": "Flavor", "count": 1 } ], "top_negative": { "text": "I did not receive this item.", "title": "Missing item.", "rating": 1, "seller_name": "Walmart.com", "customer_type": [ "VerifiedPurchaser" ], "user_nickname": "iris", "negative_feedback": 0, "positive_feedback": 0, "review_submission_time": "2/28/2026" }, "top_positive": { "text": "We ordered 5, but only delivered 4.", "rating": 5, "seller_name": "Walmart.com", "customer_type": [ "VerifiedPurchaser" ], "user_nickname": "Jia", "negative_feedback": 0, "positive_feedback": 0, "review_submission_time": "9/27/2025" }, "overall_rating": 4.8, "reviews_with_text": 22, "recommended_percentage": 75 } ``` ## Documentation ## Overview Customer reviews for a Walmart item. `query` is the numeric item id, the product URL, or the reviews URL. `page` starts at 1. `sort` is `relevancy`, `helpful`, `submission-desc`, `submission-asc`, `rating-desc`, or `rating-asc`. The response has `overall_rating`, `total_count`, `recommended_percentage`, and `ratings` with one row per star. `top_positive` and `top_negative` are the highlighted reviews. `top_mentions` are the topics Walmart counts. Each review has `position`, `title`, `text`, `rating`, `positive_feedback`, `negative_feedback`, `review_submission_time`, `user_nickname`, and `customer_type`. `product` repeats the name, URL, and categories. `pagination.next` is the next page URL, or null on the last page. `pagination.total_results` counts reviews with text, while `total_count` is every rating. Ratings are rounded to two decimals. A product with no selling price stays in stock false and omits price_map.