​
接口说明

Best Buy Reviews API 获取 Best Buy 商品评论、星级、发布时间和图片等数据。

​
请求URL

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

​
请求头

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

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

​
请求参数

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

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

​
支持站点

国家码默认每页最大每页
US2020
CA20100

评论按最新排序。

​
响应值

返回值类型说明
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 字段说明

返回值类型说明
withTextCountnull有文字的评论数量；平台未提供时为 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 字段说明

返回值类型说明
statsobjectstats

​
data.statistics.stats 字段说明

返回值类型说明
verifiedPurchaseCountintegerverifiedPurchaseCount
overallStatsobjectoverallStats
prosDistributionobject[]prosDistribution
skustringsku
distributionobject[]distribution
consDistributionobject[]consDistribution

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/bestbuy/reviews \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "country": "US",
  "productId": "6579466"
}'

​
返回示例

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

{
  "code": 0,
  "pointCost": 16.0,
  "data": {
    "country": "US",
    "pagination": {
      "nextPage": 2,
      "totalPages": 17,
      "pageSize": 20,
      "hasNext": true,
      "page": 1
    },
    "productId": "6579466",
    "query": {
      "includeRatings": true,
      "pageSize": 20,
      "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": 330,
      "reported": 330,
      "returned": 20,
      "withText": 20
    },
    "platform": "bestbuy",
    "sourceUrl": "https://www.bestbuy.com/product/roborock-s8-maxv-ultra-robot-vacuum-and-mop-with-flexiarm-design-side-brush-10000-pa-suction-and-8-in-1-rockdock-ultra-white/...",
    "provider": "bestbuy-us",
    "meta": {
      "cache": "miss",
      "stale": false,
      "ageSeconds": 0,
      "operationId": "211724e6-9df7-485c-95eb-aa777451eafe",
      "upstreamAttempts": 1,
      "coalesced": false
    },
    "schemaFingerprint": "7fc5f8804fe7f91959bbeea3a52aecab870389d4a2094783474e73eff6f7a0c2",
    "capturedAt": "2026-11-07T11:49:31.162Z",
    "productSummary": {
      "withTextCount": null,
      "reviewCount": null,
      "averageRating": 4.4,
      "scope": "upstream_product_or_review_group",
      "warnings": [],
      "source": "Best Buy US stats.overallStats",
      "totalCount": 330,
      "countKind": "platform_review_total",
      "starDistribution": {
        "1": 29,
        "2": 8,
        "3": 18,
        "4": 31,
        "5": 244
      }
    },
    "results": [
      {
        "date": "2026-10-14",
        "imgs": [],
        "merchantResponses": [],
        "syndication": {
          "incentivized": true
        },
        "star": "5.0",
        "author": "G2K305",
        "actualProductId": "6579466",
        "videos": [],
        "language": null,
        "title": "Great product",
        "photos": [],
        "content": "Great product been using it foryears now  Wuiet and efficient",
        "createdAt": "2026-10-14T17:00:19.000-05:00",
        "actualProductUrl": null,
        "purchased": true,
        "native": {
          "negativeFeedbackCount": 0,
          "author": "G2K305",
          "rating": 5,
          "brandResponses": [],
          "secondaryRatings": [],
          "title": "Great product",
          "qualityRating": null,
          "writeCommentUrl": "/site/reviews/submission/6579466/review/444218848?campaignid=RR_&return=",
          "photos": [],
          "easeOfUseRating": null,
          "submissionTime": "2026-10-14T17:00:19.000-05:00",
          "topicType": "review",
          "recommended": true,
          "commentCount": 0,
          "badges": [
            {
              "badgeDescription": "This reviewer received promo considerations or sweepstakes entry for writing a review.",
              "fileName": null,
              "iconText": null,
              "badgeType": "Custom",
              "badgeName": "Incentivized",
              "badgeCode": "Incentivized",
              "index": 90900,
              "iconPath": null
            }
          ],
          "pros": null,
          "positiveFeedbackCount": 0,
          "valueRating": null,
          "id": "1b68b50a-965c-31a4-96fb-b82858863cbe",
          "text": "Great product been using it foryears now  Wuiet and efficient",
          "daysOfOwnership": 549,
          "cons": null
        },
        "reviewId": "1b68b50a-965c-31a4-96fb-b82858863cbe"
      }
    ],
    "statistics": {
      "stats": {
        "verifiedPurchaseCount": 316,
        "overallStats": {
          "topRated": false,
          "overallConsDistributions": [
            {
              "roundedPercent": 50,
              "count": 7,
              "value": "Durability",
              "actualPercent": 50
            }
          ],
          "averageOverallRating": 4.4,
          "overallProsDistributions": [
            {
              "roundedPercent": 49,
              "count": 115,
              "value": "Cleaning Performance",
              "actualPercent": "48.93617021276596"
            }
          ],
          "recommendedPercent": 85,
          "overallDistributions": [
            {
              "roundedPercent": 74,
              "count": 244,
              "value": 5,
              "actualPercent": "73.93939393939394"
            }
          ],
          "totalReviewCount": 330
        },
        "prosDistribution": [
          {
            "roundedPercent": 49,
            "count": 115,
            "value": "Cleaning Performance",
            "actualPercent": "48.93617021276596"
          }
        ],
        "sku": "6579466",
        "distribution": [
          {
            "roundedPercent": 74,
            "count": 244,
            "value": 5,
            "actualPercent": "73.93939393939394"
          }
        ],
        "consDistribution": [
          {
            "roundedPercent": 50,
            "count": 7,
            "value": "Durability",
            "actualPercent": 50
          }
        ]
      }
    }
  },
  "message": "ok"
}

​
积点消耗说明

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

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