Walmart Reviews
Walmart reviews by item id or URL. Returns the star breakdown, highlighted reviews, mentions, and one page of customer reviews.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringItem id, product URL, or reviews URL.
Example (item id):
138762768Example (reviews URL):
https://www.walmart.com/reviews/product/138762768page?numberPage number, starting at 1.
Example:
2sort?stringReview sort.
Example:
relevancyAllowed: relevancy, helpful, submission-desc, submission-asc, rating-desc, rating-asc.
return_page_source?booleanWhen true, return {"result": html} instead of the parsed reviews.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
product?ratings?array<>reviews?array<>pagination?total_count?integertop_mentions?array<>top_negative?top_positive?overall_rating?numberreviews_with_text?integerrecommended_percentage?integercurl -X GET 'https://api.piloterr.com/v2/walmart/reviews?query=string'{ "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}