> ## 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 Catalog Search

> Full-catalog Naver Shopping search — deep, paginated product results (pages 1–5) with sort control.

Run a **full-catalog Naver Shopping search** against `search.shopping.naver.com`. Unlike the finder preview, this is the deep catalog feed with sort control and pagination through pages 1–5. Each product carries its catalogue identity, price, review stats, delivery fee and category path.

**Credits:** 5

> [!NOTE]
>
> This endpoint clears Naver's shopping captcha in a live browser session, so it is the heaviest Naver call and a page can take up to \~90 seconds. Pages are capped at 5; sorted lists are capped upstream at \~120 items. Sponsored rows stay in `products` flagged `is_ad`.

## Authorization

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

Your ScrapeBadger API key.

## Query Parameters

**query** `string` *required*

Search keywords (1–200 chars).

**sort** `string` (default: RECOMMEND)

`RECOMMEND`, `LOW_PRICE`, `HIGH_PRICE`, `PURCHASE`, `REVIEW` or `RECENT`.

**page** `integer` (default: 1)

1-based page, `1`–`5`. Page 1 is the SSR page; pages 2+ use the catalog XHR.

## Response

**query** `string`

**sort** `string`

**page** `integer`

**page\_size** `integer`

**total** `integer`

Total catalog matches, when Naver reports it.

**cursor** `integer`

Cursor for the next page, when present.

**has\_more** `boolean`

Whether another page is available (within the 5-page cap).

**result\_count** `integer`

**preview\_only** `boolean`

Always `false` — this is the full catalog feed.

**products** `Product[]`

Catalog products.

**Product**

**rank** `integer`

**nv\_mid** `string`

Naver Shopping catalogue id.

**title** `string`

**price** `integer`

**discounted\_price** `integer`

**discount\_rate** `integer`

**image\_url** `string`

**product\_url** `string`

**channel\_product\_id** `string`

**mall\_name** `string`

**mall\_id** `string`

**mall\_seq** `string`

**review\_score** `number`

**review\_count** `integer`

**delivery\_fee** `integer`

**category\_path** `string[]`

**leaf\_category\_id** `string`

**is\_ad** `boolean`

**pages** `PageSummary[]`

Per-page summary, including the overlap count with earlier pages.

**PageSummary**

**page** `integer`

**result\_count** `integer`

**repeated\_count** `integer`

Items on this page already seen on an earlier page.

**source\_url** `string`

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/shopping/search-catalog?query=로봇청소기&sort=LOW_PRICE&page=1" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/shopping/search-catalog?" +
    new URLSearchParams({"query": "로봇청소기", "sort": "LOW_PRICE", "page": "1"}),
  { 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/search-catalog",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "로봇청소기", "sort": "LOW_PRICE", "page": "1"},
)
data = res.json()
```

```json Response theme={null}
{
  "query": "로봇청소기",
  "sort": "LOW_PRICE",
  "page": 1,
  "page_size": 40,
  "total": 1200,
  "cursor": 41,
  "has_more": true,
  "result_count": 40,
  "preview_only": false,
  "products": [
    {
      "rank": 1,
      "nv_mid": "82613999001",
      "title": "로보락 S8 로봇청소기",
      "price": 899000,
      "discounted_price": 799000,
      "discount_rate": 11,
      "image_url": "https://shopping-phinf.example.net/82613999001.jpg",
      "product_url": "https://shopping.naver.com/catalog/82613999001",
      "channel_product_id": "7009999001",
      "mall_name": "로보락 공식스토어",
      "mall_id": "roborock",
      "mall_seq": "55123",
      "review_score": 4.7,
      "review_count": 8842,
      "delivery_fee": 0,
      "category_path": [
        "디지털/가전",
        "생활가전",
        "청소기"
      ],
      "leaf_category_id": "50002100",
      "is_ad": false
    }
  ],
  "pages": [
    {
      "page": 1,
      "result_count": 40,
      "repeated_count": 0
    }
  ],
  "source_url": "https://search.shopping.naver.com/ns/search?query=로봇청소기"
}
```

## 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.