Piloterr

Walmart Reviews

GET
/v2/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

Autorisierung

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Abfrageparameter

query*string

Item id, product URL, or reviews URL.

Example (item id):

138762768

Example (reviews URL):

https://www.walmart.com/reviews/product/138762768
page?number

Page number, starting at 1.

Example:

2
sort?string

Review sort.

Example:

relevancy

Allowed: relevancy, helpful, submission-desc, submission-asc, rating-desc, rating-asc.

return_page_source?boolean

When true, return {"result": html} instead of the parsed reviews.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
product?
ratings?array<>
reviews?array<>
pagination?
total_count?integer
top_mentions?array<>
top_negative?
top_positive?
overall_rating?number
reviews_with_text?integer
recommended_percentage?integer
Example Request
curl -X GET 'https://api.piloterr.com/v2/walmart/reviews?query=string'
Example Response
{  "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}