분야별 트렌드 조회

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

쇼핑 인사이트 API는 네이버 데이터랩의 쇼핑인사이트 데이터를 조회하는 RESTful API입니다. 네이버 통합검색의 쇼핑 영역과 네이버쇼핑에서 특정 쇼핑 분야의 검색 클릭 추이를 쇼핑 분야별로 확인할 수 있습니다.

요청

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

메서드	URI
POST	/shopping/v1/categories

요청 헤더

NAVER API HUB에서 공통으로 사용하는 헤더에 대한 정보는 NAVER API HUB 요청 헤더를 참조해 주십시오.

요청 바디

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

필드	타입	필수 여부	설명
`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`	Array	Required	분야 이름과 분야 코드 쌍의 배열: category 최대 3개의 쌍 설정 가능
`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세 이상 기본값: 모든 연령

필드	타입	필수 여부	설명
`name`	String	Required	쇼핑 분야 이름
`param`	Array	Required	쇼핑 분야 코드 네이버쇼핑에서 카테고리 선택 시 URL의 `cat_id` 파라미터 값으로 확인

요청 예시

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

curl --location --request POST https://naverapihub.apigw.ntruss.com/shopping/v1/categories
--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": [
        { "name": "패션의류", "param": ["50000000"] },
        { "name": "화장품/미용", "param": ["50000002"] }
    ],
    "device": "pc",
    "gender": "f",
    "ages": ["20", "30"]
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드	타입	필수 여부	설명
`startDate`	String	-	조회 기간 시작 날짜 (`yyyy-mm-dd`)
`endDate`	String	-	조회 기간 종료 날짜 (`yyyy-mm-dd`)
`timeUnit`	String	-	구간 단위
`results`	Array	-	조회 결과 목록: results

results

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

필드	타입	필수 여부	설명
`title`	String	-	쇼핑 분야 이름
`category`	Array	-	쇼핑 분야 코드
`data`	Array	-	구간별 클릭 추이 데이터: data

data

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

필드	타입	필수 여부	설명
`period`	String	-	구간별 시작 날짜 (`yyyy-mm-dd`)
`ratio`	Number	-	구간별 클릭량의 상대적 비율 구간별 결과에서 가장 큰 값을 100으로 설정한 상댓값

응답 상태 코드

NAVER API HUB에서 공통으로 사용하는 응답 상태 코드에 대한 설명은 NAVER API HUB 응답 상태 코드를 참조해 주십시오.

응답 예시

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

{
    "startDate": "2023-11-01",
    "endDate": "2023-11-07",
    "timeUnit": "date",
    "results": [
        {
            "title": "패션의류",
            "category": [
                "50000000"
            ],
            "data": [
                {
                    "period": "2023-11-01",
                    "ratio": 76.30839
                },
                {
                    "period": "2023-11-02",
                    "ratio": 70.00509
                },
                {
                    "period": "2023-11-03",
                    "ratio": 58.90771
                },
                {
                    "period": "2023-11-04",
                    "ratio": 26.00485
                }
            ]
        },
        {
            "title": "화장품/미용",
            "category": [
                "50000002"
            ],
            "data": [
                {
                    "period": "2023-11-01",
                    "ratio": 36.68978
                },
                {
                    "period": "2023-11-02",
                    "ratio": 33.19327
                },
                {
                    "period": "2023-11-03",
                    "ratio": 28.63321
                },
                {
                    "period": "2023-11-04",
                    "ratio": 9.03361
                }
            ]
        }
    ]
}

Documentation Index