Walmart

List Walmart product reviews

List reviews of a Walmart product with ratings, reviewer details, photos and review statistics.

GET/v1/walmart/product/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
productIdstringrequiredquery

Walmart item id (`16101019327`) or product page URL (`https://www.walmart.com/ip/Beautiful-3-Qt-Air-Fryer/16101019327`).

min 1 chars · max 500 chars

sortstringoptionalquery

Order of the reviews: `relevance` (default), `newest`, `oldest`, `highest_rating`, `lowest_rating` or `most_helpful`.

one of: relevance, newest, oldest, highest_rating, lowest_rating, most_helpful

ratingintegeroptionalquery

Only reviews with this many stars, 1 to 5. Default: every rating.

≥ 1 · ≤ 5

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.

min 1 chars · max 4096 chars

Response fields
70

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Walmart has no product with this id; a product with no reviews is `found` with an empty list.

one of: found, not_found

dataproductId
string

The item id asked for.

dataproductName
stringnullable

Name of the product; null when not found.

datatotalResults
integernullable

Reviews matching the filters, across every page.

Review statistics; null when not found.

datastatsaverageRating
numbernullable

Average stars out of 5.

datastatsreviewCount
integernullable

Ratings and reviews, every page.

datastatsreviewsWithTextCount
integernullable

Reviews with text: the ones the list pages through.

datastatsrecommendedPercentage
numbernullable

Share of reviewers who recommend it, 0 to 100.

Ratings per star, 5 stars first.

datastatsratingDistribution[]rating
integer

Stars, 1 to 5.

datastatsratingDistribution[]count
integer

Ratings with that many stars.

datastatsphotoCount
integernullable

Photos and videos across every review.

Topics reviewers mention most.

datastatsaspects[]id
string

Aspect id.

datastatsaspects[]name
string

What reviewers talk about, e.g. `Design`.

datastatsaspects[]mentionCount
integernullable

Reviews that mention it.

The site's summary of what reviewers say; empty when it shows none.

datastatssummary[]name
string

Topic, e.g. `flavor`.

datastatssummary[]label
stringnullable

Short label, e.g. `Delicious flavor`.

datastatssummary[]text
stringnullable

One-line summary.

datastatssummary[]polarity
stringnullable

`Positive` or `Negative`.

Reviews on this page.

datareviews[]id
string

Review id.

datareviews[]productId
stringnullable

Item the review was written for; another variant of the same product can differ from `productId`.

datareviews[]rating
integernullable

Stars, 1 to 5.

datareviews[]title
stringnullable

Review title.

datareviews[]text
stringnullable

Review text.

datareviews[]submittedAt
stringnullable

Day it was posted, `YYYY-MM-DD`; null when not shown.

datareviews[]authorId
stringnullable

Reviewer's id.

datareviews[]authorNickname
stringnullable

Reviewer's nickname.

datareviews[]authorLocation
stringnullable

Reviewer's location.

datareviews[]isVerifiedPurchaser
boolean

Whether the site marks the reviewer a verified buyer.

datareviews[]isSyndicated
boolean

Whether the review was first posted on another site.

datareviews[]isRecommended
booleannullable

Whether the reviewer recommends it; null when not said.

datareviews[]helpfulCount
integernullable

Readers who found it helpful.

datareviews[]notHelpfulCount
integernullable

Readers who did not.

datareviews[]locale
stringnullable

Language and country it was written in, e.g. `en_US`.

datareviews[]sellerName
stringnullable

Seller the reviewer bought from.

datareviews[]fulfilledBy
stringnullable

Who delivered the order, e.g. `Walmart`.

Badges on the review, e.g. `Verified Purchase`.

datareviews[]badges[]
stringoptional

Variant the reviewer bought.

datareviews[]features[]name
string

Variant attribute, e.g. `Color`.

datareviews[]features[]value
string

Its value, e.g. `White Icing`.

Attached photos.

datareviews[]photos[]id
stringnullable

Photo or video id.

datareviews[]photos[]url
stringnullable

Full-size URL.

datareviews[]photos[]thumbnailUrl
stringnullable

Thumbnail URL.

datareviews[]photos[]caption
stringnullable

Caption, when given.

Attached videos.

datareviews[]videos[]id
stringnullable

Photo or video id.

datareviews[]videos[]url
stringnullable

Full-size URL.

datareviews[]videos[]thumbnailUrl
stringnullable

Thumbnail URL.

datareviews[]videos[]caption
stringnullable

Caption, when given.

Replies from the brand or seller.

datareviews[]brandResponses[]name
stringnullable

Who responded.

datareviews[]brandResponses[]text
stringnullable

Response text.

datareviews[]brandResponses[]respondedAt
stringnullable

Day they responded, `YYYY-MM-DD`.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list stops here before its end: more rows exist (see `totalResults`) but no further page can be read.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/walmart/product/reviews?productId=16101019327" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Walmart product reviews.