​
接口说明

Target Rating Summary API 获取 Target 商品的整体评分、总量及星级分布。

​
请求URL

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

​
请求头

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

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

​
请求参数

参数必填类型说明
productIdNostring商品ID，必须用字符串传递；与productUrl二选一。
productUrlNostring配置站点的商品链接，可替代productId。
最多字符: 2048
allowStaleNoboolean默认false；true允许失败时返回旧缓存，meta会注明。
refreshNoboolean默认false；true跳过新鲜缓存。

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

支持站点：US。

直接返回商品整体评分统计，无需分页。

​
响应值

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

​
返回参数 data 说明

返回值类型说明
countrystring采集站点国家，不代表评论作者的国家。
productIdstring商品 ID，以字符串返回。
metaobject采集状态、缓存信息等元数据。
warningsstring[]采集范围及数据口径提示。
capturedAtstring本次数据采集时间。
productSummaryobject | nullUpstream product/review-group aggregate; never calculated from a partial page.
platformstring平台标识。

​
data.meta 字段说明

返回值类型说明
supplementalAttemptsintegersupplementalAttempts
reviewPageobjectreviewPage
statusstring采集完成状态。

​
data.meta.reviewPage 字段说明

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

​
data.productSummary 字段说明

返回值类型说明
averageRatingnumber | null商品整体平均评分。
最小值: 0
最大值: 5
totalCountinteger平台统计总数，含义由 countKind 说明。
最小值: 0
countKindany统计口径，区分全部评分与文字评论。
可用值: [“platform_review_total”, “ratings”, “reviews_including_ratings_only”]
reviewCountinteger | null评论总数；平台未提供时为 null。
最小值: 0
withTextCountinteger | null有文字的评论数量；平台未提供时为 null。
最小值: 0
starDistributionobject | null1–5 星对应的数量。
sourcestring统计数据来源。
scopeany汇总覆盖范围。
可用值: [“upstream_product_or_review_group”]
warningsstring[]采集范围及数据口径提示。

​
data.productSummary.starDistribution 字段说明

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

评分总数与文字评论总数的统计口径可能不同，请结合 countKind、scope 和 source 理解；缺失值保持 null。

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

​
请求示例

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

​
返回示例

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

{
  "code": 0,
  "pointCost": 0.8,
  "data": {
    "country": "US",
    "productId": "94409105",
    "meta": {
      "supplementalAttempts": 0,
      "reviewPage": {
        "cache": "fresh",
        "stale": false,
        "ageSeconds": 4,
        "upstreamAttempts": 0,
        "coalesced": false
      },
      "status": "complete"
    },
    "warnings": [],
    "capturedAt": "2026-11-07T11:49:40.010Z",
    "productSummary": {
      "withTextCount": null,
      "reviewCount": 35,
      "averageRating": 4.47,
      "scope": "upstream_product_or_review_group",
      "warnings": [],
      "source": "Target statistics.rating; review_count is separate",
      "totalCount": 64,
      "countKind": "ratings",
      "starDistribution": {
        "1": 5,
        "2": 2,
        "3": 3,
        "4": 2,
        "5": 52
      }
    },
    "platform": "target"
  },
  "message": "ok"
}

​
积点消耗说明

每个商品汇总消耗0.8积点。

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