> ## 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 Keyword Periods

> The list of available periods for the Naver Shopping keyword ranking, for a category and age bracket.

List the **available periods** for the Naver Shopping keyword ranking — the weeks or months you can request from [`/shopping/keywords`](https://docs.scrapebadger.com/api-reference/endpoint/naver/shopping-keywords) for a given category and age bracket. The complete period list is returned in one response.

**Credits:** 5

## Authorization

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

Your ScrapeBadger API key.

## Query Parameters

**category\_id** `string` (default: A)

`A`, or an 8-digit category id.

**age\_type** `string` (default: ALL)

Age bracket, e.g. `ALL`, `MEN_20`.

**sort\_type** `string` (default: KEYWORD\_NEW)

Fixed at `KEYWORD_NEW`.

**period\_type** `string` (default: WEEKLY)

`WEEKLY` or `MONTHLY`.

## Response

**category\_id** `string`

**age\_type** `string`

**sort\_type** `string`

**period\_type** `string`

**result\_count** `integer`

**periods** `Period[]`

Available periods.

**Period**

**ymd** `string`

Period start date, `YYYYMMDD`.

**ended\_at** `string`

Period end date.

**month** `integer`

**week** `integer`

**period\_type** `string`

**has\_next** `boolean`

**has\_prev** `boolean`

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/shopping/keyword-periods?category_id=A&period_type=WEEKLY" \
  -H "X-API-Key: YOUR_API_KEY"
```

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

```json Response theme={null}
{
  "category_id": "A",
  "age_type": "ALL",
  "sort_type": "KEYWORD_NEW",
  "period_type": "WEEKLY",
  "result_count": 12,
  "periods": [
    {
      "ymd": "20260804",
      "ended_at": "20260810",
      "month": 8,
      "week": 1,
      "period_type": "WEEKLY",
      "has_next": false,
      "has_prev": true
    }
  ]
}
```

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