​
API Description

Walmart Rating Summary API Collect aggregate ratings, counts and star distributions for Walmart products.

​
Request URL

POST https://scrapeapi.pangolinfo.com/api/v1/ecommerce/walmart/product-summary

​
Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Collection timeout: 90 seconds. Allow at least 105 seconds in your client.

​
Request Parameters

ParameterRequiredTypeDescription
countryYesstringStorefront country code.
Values: [“CA”, “US”]
productIdNostringProduct ID as a string; supply productId or productUrl.
productUrlNostringProduct URL on a configured storefront; alternative to productId.
Maximum length: 2048
allowStaleNobooleanDefaults to false; true permits stale cache on failure, identified in meta.
refreshNobooleanDefaults to false; true bypasses fresh cache.

Supply at least one of productId or productUrl. Product IDs must be strings.

Supported storefronts: US、CA。

Returns product-level rating statistics without pagination.

​
Response Fields

FieldTypeDescription
codeintegerStatus code; 0 indicates success.
messagestringResponse message; ok on success.
pointCostnumberPoints charged for the complete response.
dataobject | nullCollected data, described below.

​
data Fields

FieldTypeDescription
countrystringStorefront country, not the review author’s country.
productIdstringProduct ID, returned as a string.
metaobjectCollection status and cache metadata.
warningsstring[]Collection scope and data interpretation notes.
capturedAtstringCollection timestamp.
productSummaryobject | nullUpstream product/review-group aggregate; never calculated from a partial page.
platformstringPlatform identifier.

​
data.meta Fields

FieldTypeDescription
supplementalAttemptsintegersupplementalAttempts
reviewPageobjectreviewPage
statusstringCollection completion status.

​
data.meta.reviewPage Fields

FieldTypeDescription
cachestringcache
stalebooleanstale
ageSecondsintegerageSeconds
upstreamAttemptsintegerupstreamAttempts
coalescedbooleancoalesced

​
data.productSummary Fields

FieldTypeDescription
averageRatingnumber | nullAggregate average rating.
Minimum: 0
Maximum: 5
totalCountintegerPlatform total, interpreted using countKind.
Minimum: 0
countKindanyCount semantics, distinguishing all ratings from text reviews.
Values: [“platform_review_total”, “ratings”, “reviews_including_ratings_only”]
reviewCountinteger | nullReview count; null when unavailable.
Minimum: 0
withTextCountinteger | nullText review count; null when unavailable.
Minimum: 0
starDistributionobject | nullCounts for ratings from 1 to 5 stars.
sourcestringSource of the aggregate statistics.
scopeanyScope covered by the aggregate.
Values: [“upstream_product_or_review_group”]
warningsstring[]Collection scope and data interpretation notes.

​
data.productSummary.starDistribution Fields

FieldTypeDescription
1integer1
Minimum: 0
2integer2
Minimum: 0
3integer3
Minimum: 0
4integer4
Minimum: 0
5integer5
Minimum: 0

Rating and text-review totals may use different count semantics. Interpret them using countKind, scope and source; unavailable values remain null.

Errors retain the response envelope and data.error. Codes: invalid parameters 1002, rate limit 4029, busy 5001, collection failure 9200. HTTP 503 cooldown responses retain Retry-After.

​
Request Example

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/ecommerce/walmart/product-summary \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "country": "US",
  "productId": "16007120870"
}'

​
Response Example

This excerpt retains the first list item and shortens long text and URLs. pointCost is the charge for the complete response.

{
  "code": 0,
  "pointCost": 0.8,
  "data": {
    "country": "US",
    "productId": "16007120870",
    "meta": {
      "supplementalAttempts": 0,
      "reviewPage": {
        "cache": "fresh",
        "stale": false,
        "ageSeconds": 3,
        "upstreamAttempts": 0,
        "coalesced": false
      },
      "status": "complete"
    },
    "warnings": [],
    "capturedAt": "2026-11-07T11:49:23.822Z",
    "productSummary": {
      "withTextCount": 116,
      "reviewCount": null,
      "averageRating": 4.1,
      "scope": "upstream_product_or_review_group",
      "warnings": [],
      "source": "SSR data.reviews product aggregate",
      "totalCount": 621,
      "countKind": "reviews_including_ratings_only",
      "starDistribution": {
        "1": 96,
        "2": 39,
        "3": 38,
        "4": 77,
        "5": 371
      }
    },
    "platform": "walmart"
  },
  "message": "ok"
}

​
Points Usage

0.8 points per rating summary.

Each successful call is billed independently, including cached responses. Errors and empty lists cost zero; pointCost reports the charge.