> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopping Price Compare

> Seller offers per catalog product from Naver's 가격비교 (price-comparison) page — the lowest-price mall rows for each catalog match.

Fetch **seller offers per catalog product** from Naver's 가격비교 (price-comparison) page. For each catalog entry matching the query you get the catalog identity, the total offer count and the first few lowest-price seller rows.

**Credits:** 5

> [!NOTE]
>
> Clears Naver's shopping captcha in a live browser session. One page of offers is served per call, and each catalog entry exposes its first 5 lowest-price rows.

## Authorization

**X-API-Key** `string` *required*

Your ScrapeBadger API key.

## Query Parameters

**query** `string` *required*

Search keywords (1–200 chars).

## Response

**query** `string`

**entries** `Entry[]`

Catalog entries matching the query.

**Entry**

**catalog\_id** `string`

**catalog\_name** `string`

**offer\_count** `integer`

Total seller offers for this catalog entry.

**best\_price** `integer`

Lowest price across sellers, in KRW.

**offers** `Offer[]`

The first 5 lowest-price seller rows.

**Offer**

**mall\_name** `string`

**price** `integer`

That mall's price in KRW.

**nv\_mid** `string`

**product\_id** `string`

**mall\_seq** `string`

**naver\_pay** `boolean`

Whether the mall supports Naver Pay.

**price\_by\_mall** `string`

Raw upstream `lowPriceByMallNo` string for the same 5 malls.

**offers\_note** `string`

A note describing the offer-row coverage.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/shopping/price-compare?query=다이슨+에어랩" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/shopping/price-compare?" +
    new URLSearchParams({"query": "다이슨 에어랩"}),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
```

```python Python theme={null}
import requests

res = requests.get(
    "https://scrapebadger.com/v1/naver/shopping/price-compare",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "다이슨 에어랩"},
)
data = res.json()
```

```json Response theme={null}
{
  "query": "다이슨 에어랩",
  "entries": [
    {
      "catalog_id": "82614000777",
      "catalog_name": "다이슨 에어랩 컴플리트 롱",
      "offer_count": 214,
      "best_price": 529000,
      "offers": [
        {
          "mall_name": "다이슨 공식스토어",
          "price": 529000,
          "nv_mid": "82614000777",
          "product_id": "7008888001",
          "mall_seq": "41021",
          "naver_pay": true
        }
      ],
      "price_by_mall": "82614000777/41021/7008888001/529000/1/..."
    }
  ],
  "offers_note": "First 5 low-price rows per catalog entry."
}
```

## Errors

| Status | Meaning |
| - | - |
| `422` | Naver served a challenge instead of content — **not billed**. Retry; it succeeds. |
| `502` | Unexpected upstream failure — **not billed**. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.