# 네이버 브랜드스토어 상품 조회



네이버 브랜드스토어 상품 주소로 상품명·정가·판매가·할인율·리뷰 수·판매자·상품정보·태그·이미지를 조회합니다.



인증: Authorization: Bearer $APICK_API_KEY

본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다.

인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.



## POST /rest/naver_shopping_product 응답 필드

- `data` (object): 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다.

- `data.product_id` (string): 상품번호

- `data.url` (string): 상품 주소

- `data.title` (string): 상품명

- `data.original_price` (string): 할인 전 가격

- `data.final_price` (integer): 판매가

- `data.discount_rate` (integer): 할인율(%)

- `data.currency` (string): 통화

- `data.description` (string): 한 줄 설명

- `data.total_reviews` (integer): 리뷰 수

- `data.average_rating` (number): 평균 평점 null 허용.

- `data.sold_out` (boolean): 품절 여부

- `data.delivery_fee_type` (string): 배송비 유형

- `data.category_name` (string): 카테고리 null 허용.

- `data.tags` (array): 해시태그

- `data.breadcrumbs` (array): 카테고리 경로

- `data.images` (array): 이미지 주소

- `data.sellers` (array): 판매자(seller_name·final_price·currency·seller_link)

- `data.sellers[].seller_name` (string): 아래 하위 항목을 확인하세요.

- `data.sellers[].final_price` (integer): 아래 하위 항목을 확인하세요.

- `data.sellers[].currency` (string): 아래 하위 항목을 확인하세요.

- `data.sellers[].seller_link` (string): 아래 하위 항목을 확인하세요.

- `data.product_information` (array): 상품정보 고시(label·value)

- `data.product_information[].label` (string): 아래 하위 항목을 확인하세요.

- `data.product_information[].value` (string): 아래 하위 항목을 확인하세요.

- `api` (object): API 호출 공통 데이터

- `api.success` (boolean): API 서버 정상 응답 여부

- `api.cost` (integer): 차감된 포인트. 실패한 응답은 0

- `api.pl_id` (integer): API 결제 로그 ID

- `api.ms` (integer): API 응답 시간(밀리초)

## API 요청: POST /rest/naver_shopping_product



### 입력

- `url` (string, 필수): 네이버 브랜드스토어 상품 주소 (예: https://brand.naver.com/{스토어}/products/{번호})



### 응답 명세

```json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "product_id": {
          "type": "string",
          "description": "상품번호"
        },
        "url": {
          "type": "string",
          "description": "상품 주소"
        },
        "title": {
          "type": "string",
          "description": "상품명"
        },
        "original_price": {
          "type": "string",
          "description": "할인 전 가격"
        },
        "final_price": {
          "type": "integer",
          "description": "판매가"
        },
        "discount_rate": {
          "type": "integer",
          "description": "할인율(%)"
        },
        "currency": {
          "type": "string",
          "description": "통화"
        },
        "description": {
          "type": "string",
          "description": "한 줄 설명"
        },
        "total_reviews": {
          "type": "integer",
          "description": "리뷰 수"
        },
        "average_rating": {
          "nullable": true,
          "type": "number",
          "description": "평균 평점"
        },
        "sold_out": {
          "type": "boolean",
          "description": "품절 여부"
        },
        "delivery_fee_type": {
          "type": "string",
          "description": "배송비 유형"
        },
        "category_name": {
          "nullable": true,
          "type": "string",
          "description": "카테고리"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "해시태그"
        },
        "breadcrumbs": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "카테고리 경로"
        },
        "images": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "이미지 주소"
        },
        "sellers": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "seller_name": {
                "type": "string"
              },
              "final_price": {
                "type": "integer"
              },
              "currency": {
                "type": "string"
              },
              "seller_link": {
                "type": "string"
              }
            }
          },
          "description": "판매자(seller_name·final_price·currency·seller_link)"
        },
        "product_information": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            }
          },
          "description": "상품정보 고시(label·value)"
        }
      },
      "description": "조회 데이터. 실패하면 error 에 안내 문구가 담깁니다."
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "description": "API 서버 정상 응답 여부"
        },
        "cost": {
          "type": "integer",
          "description": "차감된 포인트. 실패한 응답은 0"
        },
        "pl_id": {
          "type": "integer",
          "description": "API 결제 로그 ID"
        },
        "ms": {
          "type": "integer",
          "description": "API 응답 시간(밀리초)"
        }
      },
      "description": "API 호출 공통 데이터"
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "product_id": "4995061380",
    "url": "https://brand.naver.com/pulmuonebynature/products/4995061380",
    "title": "풀무원샘물 생수 500ml, 40개",
    "original_price": "22900",
    "final_price": 11600,
    "discount_rate": 49,
    "currency": "KRW",
    "description": "[풀무원샘물] 풀무원샘물 공식 홈페이지",
    "total_reviews": 92690,
    "average_rating": null,
    "sold_out": false,
    "delivery_fee_type": "FREE",
    "category_name": null,
    "tags": [
      "#생수",
      "#미네랄워터"
    ],
    "breadcrumbs": [
      "식품",
      "음료",
      "생수"
    ],
    "images": [
      "https://shop-phinf.pstatic.net/.../image.jpg?type=o1000"
    ],
    "sellers": [
      {
        "seller_name": "풀무원샘물",
        "final_price": 11600,
        "currency": "KRW",
        "seller_link": "https://brand.naver.com/pulmuonebynature"
      }
    ],
    "product_information": [
      {
        "label": "상품번호",
        "value": "4995061380"
      }
    ]
  },
  "api": {
    "success": true,
    "cost": 30,
    "pl_id": 1595635,
    "ms": 141000
  }
}

```

### curl

```curl

curl --fail-with-body --request POST 'https://apick.app/rest/naver_shopping_product' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'url=https://brand.naver.com/pulmuonebynature/products/4995061380'

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
form.append("url", "https://brand.naver.com/pulmuonebynature/products/4995061380");
const response = await fetch("https://apick.app/rest/naver_shopping_product", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
parts = [
    ("url", (None, "https://brand.naver.com/pulmuonebynature/products/4995061380")),
]
response = requests.request("POST", "https://apick.app/rest/naver_shopping_product",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'url' => 'https://brand.naver.com/pulmuonebynature/products/4995061380',
];
$curl = curl_init('https://apick.app/rest/naver_shopping_product');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## 코드·오류

## 상세 기능·요금

Method URL POST https://apick.app/rest/naver_shopping_product 실패한 호출(입력 오류, 시간 초과, 대상 없음)은 과금하지 않습니다. 공개 상품 페이지 정보만 제공합니다. 보통 1~2분30초가 걸립니다. 최대 4분까지 기다립니다. 같은 요청은 최대 10분 동안 같은 결과가 반환될 수 있습니다. API 호출 요청 요청하기 Key Value url 응답

## 상세 요청

Header 이름 필수 설명 Authorization O Bearer 인증키

## 상세 응답

Body 이름 타입 설명 data Object 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. product_id String 상품번호 url String 상품 주소 title String 상품명 original_price String 할인 전 가격 final_price Number 판매가 discount_rate Integer 할인율(%) currency String 통화 description String 한 줄 설명 total_reviews Integer 리뷰 수 average_rating Number 평균 평점 sold_out Boolean 품절 여부 delivery_fee_type String 배송비 유형 category_name String 카테고리 tags Array 해시태그 breadcrumbs Array 카테고리 경로 images Array 이미지 주소 sellers Array 판매자(seller_name·final_price·currency·seller_link) product_information Array 상품정보 고시(label·value) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer 차감된 포인트. 실패한 응답은 0 ms Integer API 응답 시간(밀리초) pl_id Integer API 결제 로그 ID

## 상세 예제

요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "product_id": "4995061380", "url": "https://brand.naver.com/pulmuonebynature/products/4995061380", "title": "풀무원샘물 생수 500ml, 40개", "original_price": "22900", "final_price": 11600, "discount_rate": 49, "currency": "KRW", "description": "[풀무원샘물] 풀무원샘물 공식 홈페이지", "total_reviews": 92690, "average_rating": null, "sold_out": false, "delivery_fee_type": "FREE", "category_name": null, "tags": [ "#생수", "#미네랄워터" ], "breadcrumbs": [ "식품", "음료", "생수" ], "images": [ "https://shop-phinf.pstatic.net/.../image.jpg?type=o1000" ], "sellers": [ { "seller_name": "풀무원샘물", "final_price": 11600, "currency": "KRW", "seller_link": "https://brand.naver.com/pulmuonebynature" } ], "product_information": [ { "label": "상품번호", "value": "4995061380" } ] }, "api": { "success": true, "cost": 30, "pl_id": 1595635, "ms": 141000 } }