Pangolinfo - Enterprise-Grade Real-Time Data Collection API

接口说明

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

请求URL

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

请求头

参数名	参数值	类型	说明
Content-Type	application/json	string	数据格式
Authorization	Bearer xxx	string	认证凭证

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

请求参数

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

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

支持站点

国家码	默认每页	最大每页
US	20	100
CA	20	100

评论按最新排序。

响应值

返回值	类型	说明
code	integer	状态码，0 表示成功。
message	string	响应信息，成功时为 ok。
pointCost	number	本次完整响应实际消耗的积点。
data	object \| null	返回数据，字段见下表。

返回参数 data 说明

返回值	类型	说明
country	string	采集站点国家，不代表评论作者的国家。
pagination	object	分页结果，续页时使用 nextPage。
productId	string	商品 ID，以字符串返回。
query	object	本次生效的检索参数。
warnings	string[]	采集范围及数据口径提示。
store	string	store
totals	object	平台报告总量与本次返回数量，口径可能不同。
platform	string	平台标识。
sourceUrl	string	sourceUrl
provider	string	provider
meta	object	采集状态、缓存信息等元数据。
schemaFingerprint	string	schemaFingerprint
capturedAt	string	本次数据采集时间。
productSummary	object	商品整体评分及星级分布。
results	object[]	本次返回的主体记录数组。
statistics	object	statistics

data.pagination 字段说明

返回值	类型	说明
nextPage	integer	下一页页码；null 表示结束。
totalPages	integer	总页数；未知时为 null。
pageSize	integer	每页记录数。
hasNext	boolean	是否还有下一页。
page	integer	本次页码。

data.totals 字段说明

返回值	类型	说明
query	integer	本次生效的检索参数。
reported	integer	reported
returned	integer	returned
withText	integer	withText

data.meta 字段说明

返回值	类型	说明
cache	string	cache
stale	boolean	stale
ageSeconds	integer	ageSeconds
operationId	string	operationId
upstreamAttempts	integer	upstreamAttempts
coalesced	boolean	coalesced

data.productSummary 字段说明

返回值	类型	说明
withTextCount	null	有文字的评论数量；平台未提供时为 null。
reviewCount	null	评论总数；平台未提供时为 null。
averageRating	number	商品整体平均评分。
scope	string	汇总覆盖范围。
warnings	any[]	采集范围及数据口径提示。
source	string	统计数据来源。
totalCount	integer	平台统计总数，含义由 countKind 说明。
countKind	string	统计口径，区分全部评分与文字评论。
starDistribution	object	1–5 星对应的数量。

data.productSummary.starDistribution 字段说明

返回值	类型	说明
1	integer	1
2	integer	2
3	integer	3
4	integer	4
5	integer	5

data.results[] 字段说明

返回值	类型	说明
reviewId	string	评论唯一标识。
content	string	正文，保留平台原文。
title	string \| null	评论或帖子标题，缺失时为 null。
author	string \| null	作者名称。
star	string \| null	评论星级，以字符串返回，如 5.0。
date	string \| null	平台评论日期。
createdAt	string \| null	发布时间，保留完整时间；不可用时为 null。
purchased	boolean \| null	是否已验证购买；未知时为 null。
imgs	string[]	图片 URL 数组。
photos	any[]	保留图片各尺寸的原始对象。
videos	any[]	视频数组。
native	object	平台原始字段；includeNative 控制是否返回。

data.statistics 字段说明

返回值	类型	说明
includes	object	includes

data.statistics.includes 字段说明

返回值	类型	说明
Products	object	Products
ProductsOrder	string[]	ProductsOrder

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

返回示例

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

{
  "code": 0,
  "pointCost": 16.0,
  "data": {
    "country": "US",
    "pagination": {
      "nextPage": 2,
      "totalPages": 24,
      "pageSize": 20,
      "hasNext": true,
      "page": 1
    },
    "productId": "4201020136",
    "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": 480,
      "reported": 480,
      "returned": 20,
      "withText": 15
    },
    "platform": "costco",
    "sourceUrl": "https://www.costco.com/p/-/roborock-qx-revo-ultra-2-robot-vacuum-and-mop-with-25000-pa-suction/4201020136",
    "provider": "bazaarvoice",
    "meta": {
      "cache": "miss",
      "stale": false,
      "ageSeconds": 0,
      "operationId": "82a12633-3d8d-4731-8e79-fa178350ed57",
      "upstreamAttempts": 1,
      "coalesced": false
    },
    "schemaFingerprint": "d1f23336be47f63b0edbdbb1b2bf8cb512fbef1df5dbd4b968dba46671eaa321",
    "capturedAt": "2026-11-07T11:49:27.724Z",
    "productSummary": {
      "withTextCount": null,
      "reviewCount": null,
      "averageRating": 4.508333333333334,
      "scope": "upstream_product_or_review_group",
      "warnings": [],
      "source": "Bazaarvoice Includes.Products[upstreamProductId].ReviewStatistics",
      "totalCount": 480,
      "countKind": "reviews_including_ratings_only",
      "starDistribution": {
        "1": 27,
        "2": 15,
        "3": 16,
        "4": 51,
        "5": 371
      }
    },
    "results": [
      {
        "date": "2026-11-06",
        "imgs": [],
        "merchantResponses": [],
        "syndication": {
          "isSyndicated": false
        },
        "star": "1.0",
        "author": "Gwen S",
        "actualProductId": "4201020136",
        "videos": [],
        "language": "en_US",
        "title": null,
        "photos": [],
        "content": "I purchased this product as it was rated very high I think I just got a lemon there were several things that were weird about it it would return to the dock ...",
        "createdAt": "2026-11-06T16:32:23.000+00:00",
        "actualProductUrl": null,
        "purchased": true,
        "native": {
          "TotalClientResponseCount": 0,
          "InappropriateFeedbackList": [],
          "UserNickname": "Gwen S",
          "Rating": 1,
          "ReviewText": "I purchased this product as it was rated very high I think I just got a lemon there were several things that were weird about it it would return to the dock ...",
          "ContextDataValues": {},
          "ProductId": "4201020136",
          "SourceClient": "costco",
          "Videos": [],
          "CommentIds": [],
          "Photos": [],
          "TotalNegativeFeedbackCount": 0,
          "RatingRange": 5,
          "CampaignId": "BV_PIE_FOLLOWUP_MPR",
          "SecondaryRatingsOrder": [],
          "UserLocation": null,
          "TotalCommentCount": 0,
          "ContextDataValuesOrder": [],
          "TagDimensionsOrder": [],
          "ClientResponses": [],
          "TotalPositiveFeedbackCount": 0,
          "CID": "ff94add2-924b-56ec-a6c2-9f6693b9e0f8",
          "IsRatingsOnly": false,
          "LastModificationTime": "2026-11-06T16:45:16.000+00:00",
          "Pros": null,
          "ProductRecommendationIds": [],
          "BadgesOrder": [
            "verifiedPurchaser"
          ],
          "AuthorId": "92ff3b46-ac31-4db0-8e6a-9e0164a544da",
          "Helpfulness": null,
          "SubmissionTime": "2026-11-06T16:32:23.000+00:00",
          "AdditionalFields": {},
          "TotalFeedbackCount": 0,
          "AdditionalFieldsOrder": [],
          "Title": null,
          "ModerationStatus": "APPROVED",
          "OriginalProductName": "Roborock QX Revo Ultra 2 Robot Vacuum and Mop with 25,000 Pa Suction",
          "IsFeatured": false,
          "TotalInappropriateFeedbackCount": 0,
          "Cons": null,
          "TagDimensions": {},
          "SecondaryRatings": {},
          "Badges": {
            "verifiedPurchaser": {
              "ContentType": "REVIEW",
              "Id": "verifiedPurchaser",
              "BadgeType": "Custom"
            }
          },
          "SubmissionId": "r12070-en__17939827Mh3X0TF1x8",
          "IsSyndicated": false,
          "IsRecommended": true,
          "LastModeratedTime": "2026-11-06T16:45:16.000+00:00",
          "Id": "273732497",
          "ContentLocale": "en_US"
        },
        "reviewId": "273732497"
      }
    ],
    "statistics": {
      "includes": {
        "Products": {
          "4201020136": {
            "CategoryId": "30809",
            "EANs": [],
            "ModelNumbers": [
              "2064561"
            ],
            "Description": "<div><strong>Warranty:</strong></div><ul><li>2-Year Warranty</li></ul><div>​</div><div><strong>For product related questions please contact Roborock&nbsp;</s...",
            "Attributes": {
              "AVAILABILITY": {
                "Values": [
                  {
                    "Locale": null,
                    "Value": "True"
                  }
                ],
                "Id": "AVAILABILITY"
              }
            },
            "ImageUrl": "https://gdx-assets.costco.com/adobe/assets/urn:aaid:aem:489fd6f3-6823-451e-8141-0299e4dc33eb/as/4201020136-847__1.avif?width=700&height=700&fit=contain",
            "BrandExternalId": "60tggeijwpplwg5eqnk8mkiek",
            "UPCs": [],
            "ReviewStatistics": {
              "FeaturedReviewCount": 0,
              "RecommendedCount": 271,
              "SecondaryRatingsAveragesOrder": [],
              "IntelligentTrustMarkDisplayEligible": true,
              "NotHelpfulVoteCount": 661,
              "AverageOverallRating": 4.508333333333334,
              "RatingDistribution": [
                {
                  "RatingValue": 5,
                  "Count": 371
                }
              ],
              "RatingsOnlyReviewCount": 183,
              "FirstSubmissionTime": "2026-06-18T22:58:47.000+00:00",
              "TagDistribution": {},
              "ContextDataDistribution": {},
              "TotalReviewCount": 480,
              "LastSubmissionTime": "2026-11-06T16:32:23.000+00:00",
              "TotalVideoCount": 0,
              "TotalPhotoCount": 59,
              "TagDistributionOrder": [],
              "TotalMediaCount": 59,
              "OverallRatingRange": 5,
              "HelpfulVoteCount": 1041,
              "NotRecommendedCount": 40,
              "ContextDataDistributionOrder": [],
              "SecondaryRatingsAverages": {}
            },
            "Name": "Roborock QX Revo Ultra 2 Robot Vacuum and Mop with 25,000 Pa Suction",
            "Brand": {
              "Id": "60tggeijwpplwg5eqnk8mkiek",
              "Name": "Roborock"
            },
            "QuestionIds": [],
            "TotalReviewCount": 480,
            "Active": true,
            "FamilyIds": [],
            "ReviewIds": [],
            "ProductPageUrl": "http://www.costco.com//.product.4201020136.html",
            "ISBNs": [],
            "Id": "4201020136",
            "Disabled": false,
            "AttributesOrder": [
              "AVAILABILITY"
            ],
            "ManufacturerPartNumbers": [
              "QX Revo Ultra 2"
            ],
            "StoryIds": []
          }
        },
        "ProductsOrder": [
          "4201020136"
        ]
      }
    }
  },
  "message": "ok"
}

积点消耗说明

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

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

快速入门

Amazon Scrapers

电商数据

社媒数据

搜索引擎数据

TRO Data API

Playground

Costco Reviews API

接口说明

请求URL

请求头

请求参数

支持站点

响应值

返回参数 data 说明

data.totals 字段说明

data.meta 字段说明

data.productSummary 字段说明

data.productSummary.starDistribution 字段说明

data.results[] 字段说明

data.statistics 字段说明

data.statistics.includes 字段说明

请求示例

返回示例

积点消耗说明

快速入门

Amazon Scrapers

电商数据

社媒数据

搜索引擎数据

TRO Data API

Playground

​接口说明

​请求URL

​请求头

​请求参数

​支持站点

​响应值

​返回参数 data 说明

​data.pagination 字段说明

​data.totals 字段说明

​data.meta 字段说明

​data.productSummary 字段说明

​data.productSummary.starDistribution 字段说明

​data.results[] 字段说明

​data.statistics 字段说明

​data.statistics.includes 字段说明

​请求示例

​返回示例

​积点消耗说明

接口说明

请求URL

请求头

请求参数

支持站点

响应值

返回参数 data 说明

data.pagination 字段说明

data.totals 字段说明

data.meta 字段说明

data.productSummary 字段说明

data.productSummary.starDistribution 字段说明

data.results[] 字段说明

data.statistics 字段说明

data.statistics.includes 字段说明

请求示例

返回示例

积点消耗说明