---
title: "연령별 트렌드 조회"
slug: "naver-api-hub-shopping-insight-age"
updated: 2026-09-17T09:15:56Z
published: 2026-09-17T09:15:56Z
canonical: "api.ncloud-docs.com/naver-api-hub-shopping-insight-age"
---

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

# 연령별 트렌드 조회

Classic/VPC 환경에서 이용 가능합니다.

쇼핑 인사이트 API는 [네이버 데이터랩](https://datalab.naver.com/)의 [쇼핑인사이트](https://datalab.naver.com/shoppingInsight/sCategory.naver) 데이터를 조회하는 RESTful API입니다. 네이버 통합검색의 쇼핑 영역과 [네이버쇼핑](https://shopping.naver.com/ns/home)에서 특정 쇼핑 분야의 검색 클릭 추이를 사용자의 연령별로 확인할 수 있습니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| POST | /shopping/v1/category/age |

### 요청 헤더

NAVER API HUB에서 공통으로 사용하는 헤더에 대한 정보는 [NAVER API HUB 요청 헤더](/docs/naver-api-hub-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `startDate` | String | Required | 조회 기간 시작 날짜 (`yyyy-mm-dd`) - 2017년 8월 1일부터 조회 가능 |
| `endDate` | String | Required | 조회 기간 종료 날짜 (`yyyy-mm-dd`) |
| `timeUnit` | String | Required | 구간 단위 - `date` \| `week` \| `month` - `date`: 일간 - `week`: 주간 - `month`: 월간 |
| `category` | String | Required | 쇼핑 분야 코드 - 네이버쇼핑에서 카테고리 선택 시 URL의 `cat_id` 파라미터 값으로 확인 |
| `device` | String | Optional | 검색 기기 - `pc` \| `mo` - `pc`: PC - `mo`: 모바일 기기 - 기본값: 모든 기기 |
| `gender` | String | Optional | 검색 사용자의 성별에 따른 조건 - `m` \| `f` - `m`: 남성 - `f`: 여성 - 기본값: 모든 성별 |
| `ages` | Array | Optional | 검색 사용자의 연령에 따른 조건 - `10` \| `20` \| `30` \| `40` \| `50` \| `60` - `10`: 10∼19세 - `20`: 20∼29세 - `30`: 30∼39세 - `40`: 40∼49세 - `50`: 50∼59세 - `60`: 60세 이상 - 기본값: 모든 연령 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request POST 'https://naverapihub.apigw.ntruss.com/shopping/v1/category/age' \
--header 'X-NCP-APIGW-API-KEY-ID: {Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {Client Secret}' \
--header 'Content-Type: application/json' \
--data '{
    "startDate": "2023-11-01",
    "endDate": "2023-11-07",
    "timeUnit": "date",
    "category": "50000000",
    "device": "pc",
    "gender": "f"
}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `startDate` | String | - | 조회 기간 시작 날짜 (`yyyy-mm-dd`) |
| `endDate` | String | - | 조회 기간 종료 날짜 (`yyyy-mm-dd`) |
| `timeUnit` | String | - | 구간 단위 |
| `results` | Array | - | 조회 결과 목록: [results](/docs/naver-api-hub-shopping-insight-age#results) |

#### results

`results`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `title` | String | - | 쇼핑 분야 이름 |
| `category` | Array | - | 쇼핑 분야 코드 |
| `data` | Array | - | 구간별 클릭 추이 데이터: [data](/docs/naver-api-hub-shopping-insight-age#data) |

#### data

`data`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `period` | String | - | 구간별 시작 날짜 (`yyyy-mm-dd`) |
| `group` | String | - | 검색 사용자의 연령 - `10` \| `20` \| `30` \| `40` \| `50` \| `60` - `10`: 10∼19세 - `20`: 20∼29세 - `30`: 30∼39세 - `40`: 40∼49세 - `50`: 50∼59세 - `60`: 60세 이상 |
| `ratio` | Number | - | 구간별 클릭량의 상대적 비율 - 구간별 결과에서 가장 큰 값을 100으로 설정한 상댓값 |

### 응답 상태 코드

NAVER API HUB에서 공통으로 사용하는 응답 상태 코드에 대한 설명은 [NAVER API HUB 응답 상태 코드](/docs/naver-api-hub-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
    "startDate": "2023-11-01",
    "endDate": "2023-11-07",
    "timeUnit": "date",
    "results": [
        {
            "title": "50000000",
            "category": [
                "50000000"
            ],
            "data": [
                {
                    "period": "2023-11-01",
                    "ratio": 0.38366,
                    "group": "10"
                },
                {
                    "period": "2023-11-01",
                    "ratio": 21.51403,
                    "group": "20"
                },
                {
                    "period": "2023-11-01",
                    "ratio": 70.26642,
                    "group": "30"
                },
                {
                    "period": "2023-11-01",
                    "ratio": 78.40142,
                    "group": "40"
                }
            ]
        }
    ]
}
```