​
接口说明

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

​
请求URL

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

​
请求头

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

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

​
请求参数

参数必填类型说明
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跳过新鲜缓存。
originProductIdNostringNaver新商品的originProductNo映射。
merchantIdNostringNaver新商品的商家编号映射。
storeSlugNostringNaver店铺slug，默认roborock。

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

​
支持站点

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

评论按最新排序。

​
响应值

返回值类型说明
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[]本次返回的主体记录数组。
statisticsnullstatistics

​
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。
averageRatingnull商品整体平均评分。
scopestring汇总覆盖范围。
warningsstring[]采集范围及数据口径提示。
sourcestring统计数据来源。
totalCountinteger平台统计总数，含义由 countKind 说明。
countKindstring统计口径，区分全部评分与文字评论。
starDistributionnull1–5 星对应的数量。

​
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 控制是否返回。

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/naver/reviews \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "productId": "13370763497"
}'

​
返回示例

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

{
  "code": 0,
  "pointCost": 16.0,
  "data": {
    "country": "KR",
    "pagination": {
      "nextPage": 2,
      "totalPages": 52,
      "pageSize": 20,
      "hasNext": true,
      "page": 1
    },
    "productId": "13370763497",
    "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": 1025,
      "reported": 1025,
      "returned": 20,
      "withText": 20
    },
    "platform": "naver",
    "sourceUrl": "https://brand.naver.com/roborock/products/13370763497",
    "provider": "naver",
    "meta": {
      "cache": "miss",
      "stale": false,
      "ageSeconds": 0,
      "operationId": "11f4ec1a-8d4c-454c-a41e-57d621f50757",
      "upstreamAttempts": 1,
      "coalesced": false
    },
    "schemaFingerprint": "735ebdcbe1e86027bb9b6b25a2021e6a1a25e4dd2bde4975ab17b2e40465226c",
    "capturedAt": "2026-11-07T11:49:45.818Z",
    "productSummary": {
      "withTextCount": null,
      "reviewCount": null,
      "averageRating": null,
      "scope": "upstream_product_or_review_group",
      "warnings": [
        "Product average rating not provided by this response."
      ],
      "source": "review response total",
      "totalCount": 1025,
      "countKind": "platform_review_total",
      "starDistribution": null
    },
    "results": [
      {
        "date": "2026-11-04",
        "imgs": [
          "https://phinf.pstatic.net/checkout.phinf/20261104_190/1793775028747xCwig_JPEG/41103.jpg"
        ],
        "merchantResponses": [],
        "syndication": null,
        "star": "5.0",
        "author": "hy****",
        "actualProductId": "13370763497",
        "videos": [],
        "language": null,
        "title": null,
        "photos": [
          {
            "attachPath": "https://phinf.pstatic.net/checkout.phinf/20261104_190/1793775028747xCwig_JPEG/41103.jpg",
            "attachHeight": 4000,
            "attachDirectoryName": "/20261104_190/1793775028747xCwig_JPEG",
            "attachDescription": "",
            "sortOrder": 0,
            "attachUrl": "https://phinf.pstatic.net/checkout.phinf/20261104_190/1793775028747xCwig_JPEG/41103.jpg",
            "attachName": "41103.jpg",
            "id": 3718474549,
            "reviewAttachmentType": "I",
            "attachSize": 3089380,
            "attachWidth": 3000
          }
        ],
        "content": "청소 성능 및 사용은 아주 만족합니다\n이 라인이 검정색만 있어서 걱정했는데 생각보다 괜찬네요 \n초반에 매핑은 청소 두어번 하니 잘 학습하네요",
        "createdAt": "2026-11-04T06:52:10.984+00:00",
        "actualProductUrl": null,
        "purchased": null,
        "native": {
          "largeCategorizeCategoryId": "50000003",
          "reviewScore": 5,
          "freeTrial": false,
          "repThumbnailAttach": {
            "attachPath": "https://phinf.pstatic.net/checkout.phinf/20261104_190/1793775028747xCwig_JPEG/41103.jpg",
            "attachHeight": 4000,
            "attachDirectoryName": "/20261104_190/1793775028747xCwig_JPEG",
            "attachDescription": "",
            "sortOrder": 0,
            "attachUrl": "https://phinf.pstatic.net/checkout.phinf/20261104_190/1793775028747xCwig_JPEG/41103.jpg",
            "attachName": "41103.jpg",
            "id": 3718474549,
            "reviewAttachmentType": "I",
            "attachSize": 3089380,
            "attachWidth": 3000
          },
          "contentsStatusType": "NORMAL",
          "reviewType": "NORMAL",
          "reviewContentAnalysisSummaryTags": [
            {
              "tagGroupNo": 107876,
              "tagPatternEndNo": 50,
              "representTagNo": 115248,
              "tagPatternStartNo": 42
            }
          ],
          "productName": "[디지털가전페스타] 로보락 S10 MaxV Slim 로봇청소기",
          "reviewAttaches": [
            {
              "attachPath": "https://phinf.pstatic.net/checkout.phinf/20261104_190/1793775028747xCwig_JPEG/41103.jpg",
              "attachHeight": 4000,
              "attachDirectoryName": "/20261104_190/1793775028747xCwig_JPEG",
              "attachDescription": "",
              "sortOrder": 0,
              "attachUrl": "https://phinf.pstatic.net/checkout.phinf/20261104_190/1793775028747xCwig_JPEG/41103.jpg",
              "attachName": "41103.jpg",
              "id": 3718474549,
              "reviewAttachmentType": "I",
              "attachSize": 3089380,
              "attachWidth": 3000
            }
          ],
          "reviewUserInfoValues": [
            {
              "itemId": 62,
              "itemValue": "2인",
              "itemOptionId": 2
            }
          ],
          "eventTitle": "",
          "repThumbnailTagNameDescription": {},
          "reviewContent": "청소 성능 및 사용은 아주 만족합니다\n이 라인이 검정색만 있어서 걱정했는데 생각보다 괜찬네요 \n초반에 매핑은 청소 두어번 하니 잘 학습하네요",
          "middleCategorizeCategoryId": "50015460",
          "id": 5098398713,
          "reviewEvaluationValueIds": [
            3000109
          ],
          "reviewServiceType": "SELLBLOG",
          "writerProfileImageUrl": "https://phinf.pstatic.net/contact/20160607_160/14652769616322QnuV_PNG/avatar_profile.png",
          "productNo": "13370763497",
          "createDate": "2026-11-04T06:52:10.984+00:00",
          "checkoutMerchantNo": 0,
          "maskedWriterId": "hy****",
          "profileImageSourceType": "NAVER_PROFILE",
          "storeType": "STOREFARM",
          "repurchase": true,
          "smallCategorizeCategoryId": "50015541",
          "reviewContentClassType": "PHOTO",
          "originProductNo": 13311948336,
          "subReviewEvaluationValueIds": [],
          "isMyReview": false,
          "checkoutMerchantId": ""
        },
        "reviewId": "5098398713"
      }
    ],
    "statistics": null
  },
  "message": "ok"
}

​
积点消耗说明

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

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