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

> Curated Naver Shopping deal products, gender-scoped — a fixed 12-item best-deal card list.

Fetch Naver Shopping's **curated deal products** (the `bestdeal` vertical). The list is gender-scoped and returns a fixed set of 12 deal cards, each with its rank, catalogue id, title, price, discount and labels.

**Credits:** 5

## Authorization

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

Your ScrapeBadger API key.

## Query Parameters

**gender** `string` *required*

`M` or `F`. A blank gender returns an empty list upstream.

## Response

**gender** `string`

Echo of the requested gender.

**result\_count** `integer`

Products returned (12).

**products** `Product[]`

Curated deal products.

**Product**

**rank** `integer`

**nv\_mid** `string`

Naver Shopping catalogue id.

**product\_id** `string`

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

**title** `string`

**image\_url** `string`

**link\_url** `string`

**price** `integer`

List price in KRW.

**price\_value** `integer`

**discount\_price** `integer`

Discounted price in KRW.

**discount\_rate** `integer`

**delivery\_fee** `integer`

**labels** `string[]`

**is\_ad** `boolean`

**is\_zzim** `boolean`

Whether the item is a “찜” (wishlist) favourite.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/shopping/deals?gender=F" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/shopping/deals?" +
    new URLSearchParams({"gender": "F"}),
  { 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/deals",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"gender": "F"},
)
data = res.json()
```

```json Response theme={null}
{
  "gender": "F",
  "result_count": 12,
  "products": [
    {
      "rank": 1,
      "nv_mid": "82613579214",
      "product_id": "5123456789",
      "channel_product_id": "7001234567",
      "title": "여성 여름 린넨 원피스",
      "image_url": "https://shopping-phinf.example.net/82613579214.jpg",
      "link_url": "https://shopping.naver.com/catalog/82613579214",
      "price": 39000,
      "price_value": 39000,
      "discount_price": 29900,
      "discount_rate": 23,
      "delivery_fee": 0,
      "labels": [
        "무료배송",
        "오늘출발"
      ],
      "is_ad": false,
      "is_zzim": false
    }
  ]
}
```

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