Walmart Product Reviews and Ratings API
Overview
The Walmart Product Reviews and Ratings API allows users to input a product URL, review page number and sort options and get detailed review information in return, such as title, rating, author name, and badges. It provides an easy way to access all reviews of any Walmart product quickly and accurately.
Authentication
Visit our Authentication Docs on learning how to get started on integrating this API in your application.
Endpoint
GET https://get.scrapehero.com/api/walmart/reviews/?x-api-key=<YOUR_API_KEY>&url=https://www.walmart.com/ip/Crocs-Women-s-Baya-Platform-Clogs/2638712105?classType=VARIANT%26athbdg=L1103%26from=/search&page=2&sort=most-relevant
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Product URL |
| page | string | Optional | Page Number. By default page will be 1 |
| sort | string | Optional | Supported sort options are most-relevant, most-recent, highest-rated, lowest-rated, most-helpful. By default sort option will be most-relevant |
Response Format
The API returns data in JSON format. Here's an example of the response structure:
{
"product_name": "Crocs Women's Baya Platform Clog Sandal",
"reviews": [
{
"author_badges": [
"Verified Purchase"
],
"author_name": "anonymous",
"comment_count": 0,
"date": "14-05-2025",
"negative_feedback_count": 0,
"positive_feedback_count": 0,
"images": [
"https://i5.walmartimages.com/dfw/6e29e393-3574/k2-_4c95e6e5-8ad3-4c2e-b980-3517cee961c4.v1.jpg"
],
"is_verified_purchase": true,
"listing_page_url": "https://www.walmart.com/reviews/product/2638712105?page=2&sort=relevancy",
"rating": 5,
"retailer_review_id": "385364549",
"text": "Electric Pink Crocs arrived just as seen on Walmart website. Fit is true to size, height of shoes are neither too low nor too high. They are perfect! I love them. Affordable and name brand at the same time! I'm so happy!!",
"title": "Electric Pink Crocs for women"
},
{
"author_badges": [
"Verified Purchase"
],
"author_name": "Linda",
"comment_count": 0,
"date": "23-05-2025",
"negative_feedback_count": 0,
"positive_feedback_count": 0,
"images": [ ],
"is_verified_purchase": true,
"listing_page_url": "https://www.walmart.com/reviews/product/2638712105?page=2&sort=relevancy",
"rating": 5,
"retailer_review_id": "386456861",
"text": "They are much more comfortable than I thought they'd be. The first day I wore them to work they felt great and with the holes very cooling in the warm weather. I already ordered 2 more in different colors while they are on sale.",
"title": "Crocs"
},
{
"author_badges": [
"Verified Purchase"
],
"author_name": "Holly",
"comment_count": 0,
"date": "27-05-2025",
"negative_feedback_count": 0,
"positive_feedback_count": 0,
"images": [ ],
"is_verified_purchase": true,
"listing_page_url": "https://www.walmart.com/reviews/product/2638712105?page=2&sort=relevancy",
"rating": 4,
"retailer_review_id": "386829605",
"text": "The shoes are not as comfy for me personally, short trips like to doctors or dropping of the kids perfectly fine wanna wear them for hours maybe some fluffy socks will help but they can start to leave marks on your feet if you don't.",
"title": null
},
{
"author_badges": [
"Verified Purchase"
],
"author_name": "Eileen",
"comment_count": 0,
"date": "17-05-2025",
"negative_feedback_count": 0,
"positive_feedback_count": 0,
"images": [ ],
"is_verified_purchase": true,
"listing_page_url": "https://www.walmart.com/reviews/product/2638712105?page=2&sort=relevancy",
"rating": 5,
"retailer_review_id": "385703108",
"text": "These shoes were perfect! They feel very soft and supportive they also felt very soft. I loved the color. The pink is very pretty. I also like the heel. One of the most comfortable shoes I have had in a while.",
"title": null
},
{
"author_badges": [
"Verified Purchase"
],
"author_name": "anonymous",
"comment_count": 0,
"date": "14-05-2025",
"negative_feedback_count": 0,
"positive_feedback_count": 0,
"images": [ ],
"is_verified_purchase": true,
"listing_page_url": "https://www.walmart.com/reviews/product/2638712105?page=2&sort=relevancy",
"rating": 2,
"retailer_review_id": "385400904",
"text": "they remind me a bit of clown shoes. i wear a size 9, but 9 usually doesnt fit, the next size up fits, but these clogs have a bigger or thicker sole. again clown shoes.",
"title": "bright pink cloggers"
},
{
"author_badges": [
"Verified Purchase"
],
"author_name": "Lrose1956",
"comment_count": 0,
"date": "12-05-2025",
"negative_feedback_count": 0,
"positive_feedback_count": 0,
"images": [
"https://i5.walmartimages.com/dfw/6e29e393-a3d4/k2-_296c88e4-b6dc-41a9-a13e-4a7f1a1ba6cb.v1.jpg",
"https://i5.walmartimages.com/dfw/6e29e393-b436/k2-_e11ac79c-5956-4157-a6c4-86a48b4b1d37.v1.jpg",
"https://i5.walmartimages.com/dfw/6e29e393-55ff/k2-_fff1b428-198d-4072-a6c2-9af6c4d649a0.v1.jpg"
],
"is_verified_purchase": true,
"listing_page_url": "https://www.walmart.com/reviews/product/2638712105?page=2&sort=relevancy",
"rating": 5,
"retailer_review_id": "385133951",
"text": "Their very nice but they seem to run a little bigger. I'm going to go ahead and keep them, but they are just a little big so my opinion would be go down a size when you order these.",
"title": "Nice for the price"
}
],
"next_page_url": "https://www.walmart.com/reviews/product/2638712105&page=3&sort=most-relevant",
"total_pages": 55
}
Response Fields
| Field | Type | Description |
|---|---|---|
| Property | Type | Description |
| date | String | Date |
| text | String | Review body |
| title | String | Review title |
| images | List | Images |
| rating | Integer | rating |
| author_name | String | Author name |
| author_badges | List | Author badges |
| comment_count | Integer | Comment count |
| listing_page_url | String | Listing page url |
| retailer_review_id | Dict | Retailer review ID |
| is_verified_purchase | Boolean | Verified purchase or not |
| negative_feedback_count | Integer | Negative feedback count |
| positive_feedback_count | Integer | Positive feedback count |
Usage Example
Here's an example of how to use the API with Python:
- JavaScript
- Python
- Java
- Ruby
const http = require("https");
const options = {
"method": "GET",
"hostname": "get.scrapehero.com",
"port": null,
"path": "/api/walmart/reviews/?x-api-key=<YOUR_API_KEY>&url=https://www.walmart.com/ip/Crocs-Women-s-Baya-Platform-Clogs/2638712105?classType=VARIANT%26athbdg=L1103%26from=/search&page=2&sort=most-relevant",
"headers": {}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
import http.client
conn = http.client.HTTPSConnection("get.scrapehero.com")
conn.request("GET", "/api/walmart/reviews/?x-api-key=<YOUR_API_KEY>&url=https://www.walmart.com/ip/Crocs-Women-s-Baya-Platform-Clogs/2638712105?classType=VARIANT%26athbdg=L1103%26from=/search&page=2&sort=most-relevant")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
HttpResponse<String> response = Unirest.get("https://get.scrapehero.com/api/walmart/reviews/?x-api-key=<YOUR_API_KEY>&url=https://www.walmart.com/ip/Crocs-Women-s-Baya-Platform-Clogs/2638712105?classType=VARIANT%26athbdg=L1103%26from=/search&page=2&sort=most-relevant")
.asString();
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://get.scrapehero.com/api/walmart/reviews/?x-api-key=<YOUR_API_KEY>&url=https://www.walmart.com/ip/Crocs-Women-s-Baya-Platform-Clogs/2638712105?classType=VARIANT%26athbdg=L1103%26from=/search&page=2&sort=most-relevant")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
This API uses 10 data credit per API call. Learn more about data credits.
Rate Limits
Rate limits are based off the plan that you have subscribed to. To learn more about the plan specification vist our Plans page.
Response Codes
Check out the response codes here.
Best Practices
- Use appropriate error handling in your code.
- Implement exponential backoff for rate limiting.
- Cache results when possible to minimize API calls.
Support
If you encounter any issues or have questions, please contact our API support team at cloud-support@scrapehero.com or visit our API documentation at https://app.scrapehero.com/docs/api_intro.