​
API Description

Naver Shopping Reviews API Collect Naver product reviews, ratings, publication dates and images.

​
Request URL

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

​
Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Collection timeout: 90 seconds. Allow at least 105 seconds in your client.

​
Request Parameters

ParameterRequiredTypeDescription
productIdNostringProduct ID as a string; supply productId or productUrl.
productUrlNostringProduct URL on a configured storefront; alternative to productId.
Maximum length: 2048
pageNointegerPages start at 1. Continue with data.pagination.nextPage.
Default: 1
Minimum: 1
Maximum: 300001
pageSizeNointegerSee site table for defaults and limits; omit to use storefront default.
Minimum: 1
Maximum: 100
includeNativeNobooleanDefaults to true; includes original platform fields.
allowStaleNobooleanDefaults to false; true permits stale cache on failure, identified in meta.
refreshNobooleanDefaults to false; true bypasses fresh cache.
originProductIdNostringoriginProductNo mapping for new Naver products.
merchantIdNostringMerchant mapping for new Naver products.
storeSlugNostringNaver store slug; defaults to roborock.

Supply at least one of productId or productUrl. Product IDs must be strings.

​
Supported Storefronts

CountryDefault page sizeMaximum page size
KR2030

Reviews are returned in newest order.

​
Response Fields

FieldTypeDescription
codeintegerStatus code; 0 indicates success.
messagestringResponse message; ok on success.
pointCostnumberPoints charged for the complete response.
dataobject | nullCollected data, described below.

​
data Fields

FieldTypeDescription
countrystringStorefront country, not the review author’s country.
paginationobjectPagination details; continue using nextPage.
productIdstringProduct ID, returned as a string.
queryobjectEffective search parameters.
warningsstring[]Collection scope and data interpretation notes.
storestringstore
totalsobjectReported totals and returned counts, which may use different count semantics.
platformstringPlatform identifier.
sourceUrlstringsourceUrl
providerstringprovider
metaobjectCollection status and cache metadata.
schemaFingerprintstringschemaFingerprint
capturedAtstringCollection timestamp.
productSummaryobjectAggregate product rating and star distribution.
resultsobject[]Primary records returned by this request.
statisticsnullstatistics

​
data.pagination Fields

FieldTypeDescription
nextPageintegerNext page number; null indicates the end.
totalPagesintegerTotal pages; null when unknown.
pageSizeintegerRecords per page.
hasNextbooleanWhether another page is available.
pageintegerCurrent page number.

​
data.totals Fields

FieldTypeDescription
queryintegerEffective search parameters.
reportedintegerreported
returnedintegerreturned
withTextintegerwithText

​
data.meta Fields

FieldTypeDescription
cachestringcache
stalebooleanstale
ageSecondsintegerageSeconds
operationIdstringoperationId
upstreamAttemptsintegerupstreamAttempts
coalescedbooleancoalesced

​
data.productSummary Fields

FieldTypeDescription
withTextCountnullText review count; null when unavailable.
reviewCountnullReview count; null when unavailable.
averageRatingnullAggregate average rating.
scopestringScope covered by the aggregate.
warningsstring[]Collection scope and data interpretation notes.
sourcestringSource of the aggregate statistics.
totalCountintegerPlatform total, interpreted using countKind.
countKindstringCount semantics, distinguishing all ratings from text reviews.
starDistributionnullCounts for ratings from 1 to 5 stars.

​
data.results[] Fields

FieldTypeDescription
reviewIdstringUnique review identifier.
contentstringBody text in the original language.
titlestring | nullReview or post title; null when unavailable.
authorstring | nullAuthor name.
starstring | nullReview rating as a string, e.g. 5.0.
datestring | nullReview date reported by the platform.
createdAtstring | nullFull publication timestamp; null when unavailable.
purchasedboolean | nullVerified purchase status; null when unknown.
imgsstring[]Image URL array.
photosany[]Original image objects, including available sizes.
videosany[]Video array.
nativeobjectOriginal platform fields, controlled by includeNative.

imgs supports Best Buy CA imageUrl and Judge.me original. photos retains original image objects and sizes. Unavailable ratings and dates remain null.

Continue using data.pagination.nextPage until null. Deduplicate reviews across pages using reviewId.

Errors retain the response envelope and data.error. Codes: invalid parameters 1002, rate limit 4029, busy 5001, collection failure 9200. HTTP 503 cooldown responses retain Retry-After.

​
Request Example

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"
}'

​
Response Example

This excerpt retains the first list item and shortens long text and URLs. pointCost is the charge for the complete response.

{
  "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"
}

​
Points Usage

0.8 points per unique review within the response.

Each successful call is billed independently, including cached responses. Errors and empty lists cost zero; pointCost reports the charge.