JustSERPDocs
Walmart

Walmart Product Reviews

One page (ten) of a Walmart product's customer reviews, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`sorting_by`), `product` (rating statistics and histogram), `aspect_stats`, `reviews`, `ai_summary`, `bullet_review_summary`, `product_media` and `pagination`.

GET
/v1/walmart/reviews

One page (ten) of a Walmart product's customer reviews, answered as the document: search_metadata, search_parameters, search_information (sorting_by), product (rating statistics and histogram), aspect_stats, reviews, ai_summary, bullet_review_summary, product_media and pagination. total_pages counts pages of reviews that have text. verified_purchases_only is applied to the page read (Walmart's address has no such filter), so a page then holds fewer than ten. A missing product is 404 profile_not_found; the bot wall a retried captcha. zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
product_id*string

The number in the product's address.

rating?integer

ratings= in Walmart's address.

Range1 <= value <= 5
aspect_id?string

An id from aspect_stats. An aspect the product does not have answers an empty list.

Match^[0-9]+$
sort_by?string
Default"relevance"
Value in"relevance""newest""helpful""highest_rating""lowest_rating"
verified_purchases_only?boolean

Keeps the page's reviews with the Verified Purchase badge; a page then holds fewer than ten.

page?integer

Walmart pages the reviews that have text.

Range1 <= value <= 1000
Default1

Response Body

The reviews, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Walmart Product Reviews document.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

product?
aspect_stats?array<>
reviews?
ai_summary?

Walmart's generated summary when the page has it (null for the products seen).

bullet_review_summary?

As ai_summary.

product_media?array<>

Customer photos.

pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/walmart/reviews?product_id=10429811825&rating=1&sort_by=newest&page=2'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "sorting_by": "string"  },  "product": {    "title": "string",    "link": "string",    "rating": 0,    "reviews_count": 0,    "reviews_with_text_count": 0,    "reviews_histogram": {      "property1": {},      "property2": {}    },    "recommended_percentage": 0,    "media_count": 0  },  "aspect_stats": [    {      "id": "string",      "name": "string",      "count": 0    }  ],  "reviews": {    "customer_reviews": [      {        "id": "string",        "reference_id": "string",        "title": "string",        "text": "string",        "rating": 0,        "date": "string",        "iso_date": "string",        "user_id": "string",        "user_name": "string",        "positive_feedback": 0,        "negative_feedback": 0,        "badges": [          "string"        ],        "seller_name": "string",        "item_id": "string",        "item_name": "string",        "item_details": [          {}        ],        "fulfilled_by": "string"      }    ],    "top_positive_review": {      "id": "string",      "reference_id": "string",      "title": "string",      "text": "string",      "rating": 0,      "date": "string",      "iso_date": "string",      "user_id": "string",      "user_name": "string",      "positive_feedback": 0,      "negative_feedback": 0,      "badges": [        "string"      ],      "seller_name": "string",      "item_id": "string",      "item_name": "string",      "item_details": [        {}      ],      "fulfilled_by": "string"    },    "top_negative_review": {      "id": "string",      "reference_id": "string",      "title": "string",      "text": "string",      "rating": 0,      "date": "string",      "iso_date": "string",      "user_id": "string",      "user_name": "string",      "positive_feedback": 0,      "negative_feedback": 0,      "badges": [        "string"      ],      "seller_name": "string",      "item_id": "string",      "item_name": "string",      "item_details": [        {}      ],      "fulfilled_by": "string"    }  },  "ai_summary": {},  "bullet_review_summary": {},  "product_media": [    {      "id": "string",      "review_id": "string",      "type": "string",      "normal_url": "string",      "thumbnail_url": "string",      "rating": 0    }  ],  "pagination": {    "current": 0,    "next": "string",    "total_pages": 0  }}