​
接口说明

Sam’s Club Reviews API 获取 Sam’s Club 商品评论、星级、发布时间和图片等数据。

​
请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/ecommerce/samsclub/reviews

​
请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集超时90秒，客户端超时建议至少105秒。

​
请求参数

参数必填类型说明
productIdNostring商品ID，必须用字符串传递；与productUrl二选一。
productUrlNostring配置站点的商品链接，可替代productId。
最多字符: 2048
pageNointeger页码从 1 开始；使用 data.pagination.nextPage 续页。
默认值: 1
最小值: 1
最大值: 300001
includeNativeNoboolean默认true，保留原始平台字段。
allowStaleNoboolean默认false；true允许失败时返回旧缓存，meta会注明。
refreshNoboolean默认false；true跳过新鲜缓存。

productId 与 productUrl 至少填写一项；商品 ID 必须使用字符串。

​
支持站点

国家码默认每页最大每页
US1010

评论按最新排序。

​
响应值

返回值类型说明
codeinteger状态码，0 表示成功。
messagestring响应信息，成功时为 ok。
pointCostnumber本次完整响应实际消耗的积点。
dataobject | null返回数据，字段见下表。

​
返回参数 data 说明

返回值类型说明
countrystring采集站点国家，不代表评论作者的国家。
paginationobject分页结果，续页时使用 nextPage。
productIdstring商品 ID，以字符串返回。
queryobject本次生效的检索参数。
warningsstring[]采集范围及数据口径提示。
storestringstore
totalsobject平台报告总量与本次返回数量，口径可能不同。
platformstring平台标识。
sourceUrlstringsourceUrl
providerstringprovider
metaobject采集状态、缓存信息等元数据。
schemaFingerprintstringschemaFingerprint
capturedAtstring本次数据采集时间。
productSummaryobject商品整体评分及星级分布。
resultsobject[]本次返回的主体记录数组。
statisticsobjectstatistics

​
data.pagination 字段说明

返回值类型说明
nextPageinteger下一页页码；null 表示结束。
totalPagesinteger总页数；未知时为 null。
pageSizeinteger每页记录数。
hasNextboolean是否还有下一页。
pageinteger本次页码。

​
data.totals 字段说明

返回值类型说明
queryinteger本次生效的检索参数。
reportedintegerreported
returnedintegerreturned
withTextintegerwithText

​
data.meta 字段说明

返回值类型说明
cachestringcache
stalebooleanstale
ageSecondsintegerageSeconds
operationIdstringoperationId
upstreamAttemptsintegerupstreamAttempts
coalescedbooleancoalesced

​
data.productSummary 字段说明

返回值类型说明
withTextCountinteger有文字的评论数量；平台未提供时为 null。
reviewCountnull评论总数；平台未提供时为 null。
averageRatingnumber商品整体平均评分。
scopestring汇总覆盖范围。
warningsany[]采集范围及数据口径提示。
sourcestring统计数据来源。
totalCountinteger平台统计总数，含义由 countKind 说明。
countKindstring统计口径，区分全部评分与文字评论。
starDistributionobject1–5 星对应的数量。

​
data.productSummary.starDistribution 字段说明

返回值类型说明
1integer1
2integer2
3integer3
4integer4
5integer5

​
data.results[] 字段说明

返回值类型说明
reviewIdstring评论唯一标识。
contentstring正文，保留平台原文。
titlestring | null评论或帖子标题，缺失时为 null。
authorstring | null作者名称。
starstring | null评论星级，以字符串返回，如 5.0。
datestring | null平台评论日期。
createdAtstring | null发布时间，保留完整时间；不可用时为 null。
purchasedboolean | null是否已验证购买；未知时为 null。
imgsstring[]图片 URL 数组。
photosany[]保留图片各尺寸的原始对象。
videosany[]视频数组。
nativeobject平台原始字段；includeNative 控制是否返回。

​
data.statistics 字段说明

返回值类型说明
ratingValueThreeCountintegerratingValueThreeCount
ratingValueOneCountintegerratingValueOneCount
ratingValueFourCountintegerratingValueFourCount
reviewsWithTextCountintegerreviewsWithTextCount
averageOverallRatingnumberaverageOverallRating
ratingValueFiveCountintegerratingValueFiveCount
ratingValueTwoCountintegerratingValueTwoCount
totalReviewCountintegertotalReviewCount

imgs 兼容 Best Buy CA 的 imageUrl 和 Judge.me 的 original；photos 保留各尺寸原对象。评论星级、日期等缺失值保留 null。

下一页使用 data.pagination.nextPage，为 null 时结束。分页时可按 reviewId 去重。

失败保留统一响应外壳及 data.error；参数错误 code=1002、限流4029、暂忙5001、采集失败9200。HTTP 503 冷却响应保留 Retry-After。

​
请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/ecommerce/samsclub/reviews \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "productId": "13620223909"
}'

​
返回示例

下例截取实际响应首条列表记录，长文本和链接作了缩写；pointCost 为完整响应的实际费用。

{
  "code": 0,
  "pointCost": 8.0,
  "data": {
    "country": "US",
    "pagination": {
      "nextPage": 2,
      "totalPages": 14,
      "pageSize": 10,
      "hasNext": true,
      "page": 1
    },
    "productId": "13620223909",
    "query": {
      "includeRatings": true,
      "pageSize": 10,
      "page": 1,
      "sort": "newest"
    },
    "warnings": [
      "Live pagination can shift as reviews are added. Deduplicate by review ID and reconcile page 1."
    ],
    "store": "roborock",
    "totals": {
      "query": 138,
      "reported": 139,
      "returned": 10,
      "withText": 10
    },
    "platform": "samsclub",
    "sourceUrl": "https://www.samsclub.com/reviews/product/13620223909",
    "provider": "walmart-html",
    "meta": {
      "cache": "miss",
      "stale": false,
      "ageSeconds": 0,
      "operationId": "9b3c535d-c3b2-47a2-a07a-fe2d65dfe6ab",
      "upstreamAttempts": 1,
      "coalesced": false
    },
    "schemaFingerprint": "21f8465bcf2be98ab98d6644a69d4dbc377169e4a383a019d6c6773457edec2f",
    "capturedAt": "2026-11-07T11:49:37.759Z",
    "productSummary": {
      "withTextCount": 138,
      "reviewCount": null,
      "averageRating": 4.899280575539568,
      "scope": "upstream_product_or_review_group",
      "warnings": [],
      "source": "SSR data.reviews product aggregate",
      "totalCount": 139,
      "countKind": "reviews_including_ratings_only",
      "starDistribution": {
        "1": 0,
        "2": 0,
        "3": 2,
        "4": 10,
        "5": 127
      }
    },
    "results": [
      {
        "date": "2/15/2025",
        "imgs": [],
        "merchantResponses": [],
        "syndication": {
          "source": {
            "name": "us.roborock.com",
            "contentLink": null,
            "logoImageUrl": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86YXR0cmlidXRpb25sb2dvMg/10a05ae2-0b7d-4502-90d1-f7fdf56c8ac3"
          },
          "externalSource": "bazaarvoice"
        },
        "star": "5.0",
        "author": "ARF77",
        "actualProductId": null,
        "videos": [],
        "language": null,
        "title": "Live changing purchase",
        "photos": [],
        "content": "We have been wanting to purchase this for a couple years. Happy to finally have a home that can take advantage of it. It mops and vacuums flawlessly. We are ...",
        "createdAt": "2/15/2025",
        "actualProductUrl": null,
        "purchased": true,
        "native": {
          "showTranslationCTA": null,
          "snippetFromTitle": null,
          "rating": 5,
          "translatedLanguage": null,
          "sellerName": null,
          "reviewType": null,
          "userBadges": null,
          "media": [],
          "reviewSubmissionTime": "2/15/2025",
          "reviewReferenceId": "ab48ec0c-f1fb-5853-8ecd-84f14bd2ca86",
          "photos": [],
          "reviewTitle": "Live changing purchase",
          "features": [],
          "originalLocale": null,
          "itemName": "Roborock S8Pro Ultra Robot Vacuum and Mop with Auto Drying",
          "translatedLocale": null,
          "reviewAspects": [],
          "sellerId": null,
          "conditionGroupCode": null,
          "reviewAspectStart": null,
          "syndicationSource": {
            "name": "us.roborock.com",
            "contentLink": null,
            "logoImageUrl": "https://photos-us.bazaarvoice.com/photo/2/cGhvdG86YXR0cmlidXRpb25sb2dvMg/10a05ae2-0b7d-4502-90d1-f7fdf56c8ac3"
          },
          "reviewText": "We have been wanting to purchase this for a couple years. Happy to finally have a home that can take advantage of it. It mops and vacuums flawlessly. We are ...",
          "reviewSentimentEnd": null,
          "userLocation": null,
          "userNickname": "ARF77",
          "authorId": "e6ujy7ypeyhscd3ca3sdl7kq8",
          "negativeFeedback": 0,
          "originalLanguage": null,
          "recommended": true,
          "clientResponses": null,
          "externalSource": "bazaarvoice",
          "badges": [
            {
              "glassBadge": {
                "id": "VerifiedPurchaser",
                "text": "Verified Purchase"
              },
              "badgeType": "Custom",
              "id": "verifiedPurchaser",
              "contentType": "REVIEW"
            }
          ],
          "itemId": null,
          "condition": null,
          "reviewAspectEnd": null,
          "showRecommended": true,
          "positiveFeedback": 0,
          "fulfilledBy": null,
          "reviewSentimentStart": null,
          "reviewId": "337859005",
          "status": null,
          "itemImageUrl": "https://i5.walmartimages.com/asr/a8121ed1-90dd-42f9-b717-a607b70ebf6e.4adc7a2c43acb358c5d2b0369af6b77a.jpeg"
        },
        "reviewId": "337859005"
      }
    ],
    "statistics": {
      "ratingValueThreeCount": 2,
      "ratingValueOneCount": 0,
      "ratingValueFourCount": 10,
      "reviewsWithTextCount": 138,
      "averageOverallRating": 4.899280575539568,
      "ratingValueFiveCount": 127,
      "ratingValueTwoCount": 0,
      "totalReviewCount": 139
    }
  },
  "message": "ok"
}

​
积点消耗说明

每条评论消耗0.8积点，同一响应内按唯一评论计费。

每次成功请求独立计费，命中缓存也按返回主体收费；失败及空列表不扣费，以 pointCost 为准。