검색어 트렌드 조회

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

검색어 트렌드 API는 네이버 데이터랩의 검색어트렌드를 조회하는 RESTful API입니다. 주제어로 묶은 검색어에 대한 네이버 통합검색의 검색 추이 데이터를 확인할 수 있습니다.

요청

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

메서드	URI
POST	/search-trend/v1/search

요청 헤더

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

요청 바디

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

필드	타입	필수 여부	설명
`startDate`	String	Required	조회 기간 시작 날짜 (`yyyy-mm-dd`) 2016년 1월 1일부터 조회 가능
`endDate`	String	Required	조회 기간 종료 날짜 (`yyyy-mm-dd`)
`timeUnit`	String	Required	구간 단위 `date` \| `week` \| `month` `date`: 일간 `week`: 주간 `month`: 월간
`keywordGroups`	Array	Required	주제어와 주제어에 해당하는 검색어 묶음 쌍의 배열: keywordGroups 최대 5개의 쌍 설정 가능
`device`	String	Optional	검색 기기 `pc` \| `mo` `pc`: PC에서 검색 추이 `mo`: 모바일에서 검색 추이 기본값: 모든 환경
`gender`	String	Optional	검색 사용자의 성별 `m` \| `f` `m`: 남성 `f`: 여성 기본값: 모든 성별
`ages`	Array	Optional	검색 사용자의 연령 `1` \| `2` \| `3` \| `4` \| `5` \| `6` \| `7` \| `8` \| `9` \| `10` \| `11` `1`: 0∼12세 `2`: 13∼18세 `3`: 19∼24세 `4`: 25∼29세 `5`: 30∼34세 `6`: 35∼39세 `7`: 40∼44세 `8`: 45∼49세 `9`: 50∼54세 `10`: 55∼59세 `11`: 60세 이상 기본값: 모든 연령

keywordGroups

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

필드	타입	필수 여부	설명
`groupName`	String	Required	주제어 검색어 묶음을 대표하는 이름
`keywords`	Array	Required	주제어에 해당하는 검색어 최대 20개의 검색어 설정 가능

요청 예시

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

curl --location --request POST https://naverapihub.apigw.ntruss.com/search-trend/v1/search
--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-01-01",
    "endDate": "2023-06-30",
    "timeUnit": "month",
    "keywordGroups": [
        { "groupName": "한글", "keywords": ["한글", "korean"] },
        { "groupName": "영어", "keywords": ["영어", "english"] }
    ],
    "device": "pc",
    "gender": "f",
    "ages": ["3", "4", "5", "6", "7", "8", "9", "10", "11"]
}'

응답

응답 형식을 설명합니다.

응답 바디

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

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

results

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

필드	타입	필수 여부	설명
`title`	String	-	주제어
`keywords`	Array	-	주제어에 해당하는 검색어
`data`	Array	-	구간별 검색 추이 데이터: data

data

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

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

응답 상태 코드

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

응답 예시

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

{
    "startDate": "2023-01-01",
    "endDate": "2023-06-30",
    "timeUnit": "month",
    "results": [
        {
            "title": "한글",
            "keywords": [
                "한글",
                "korean"
            ],
            "data": [
                {
                    "period": "2023-01-01",
                    "ratio": 70.15342
                },
                {
                    "period": "2023-02-01",
                    "ratio": 74.21207
                },
                {
                    "period": "2023-03-01",
                    "ratio": 100
                },
                {
                    "period": "2023-04-01",
                    "ratio": 84.46829
                }
            ]
        },
        {
            "title": "영어",
            "keywords": [
                "영어",
                "english"
            ],
            "data": [
                {
                    "period": "2023-01-01",
                    "ratio": 26.67976
                },
                {
                    "period": "2023-02-01",
                    "ratio": 25.81815
                },
                {
                    "period": "2023-03-01",
                    "ratio": 29.68029
                },
                {
                    "period": "2023-04-01",
                    "ratio": 27.57161
                }
            ]
        }
    ]
}

Documentation Index