search

Prev Next

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

주제어 그룹에 대한 네이버 통합검색의 기간별 트렌드 데이터 통계를 연령, 성별, 검색 환경별로 분석하여 JSON 형태로 제공합니다.

참고

NAVER DataLab의 검색어 트렌드 검색 결과와 동일합니다.

요청

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

메서드 URI
POST /search

요청 헤더

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

요청 바디

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

필드 타입 필수 여부 설명
startDate String Required 데이터 조회 시작 날짜(yyyy-MM-dd)
  • 2016년 01월 01일부터 조회 가능
endDate String Required 데이터 조회 종료 날짜(yyyy-MM-dd)
timeUnit String Required 데이터 조회 구간 단위
  • date | week | month
    • date: 일간 데이터 조회
    • week: 주간 데이터 조회
    • month: 월간 데이터 조회
keywordGroups Array<String> Required
device String Optional 검색 디바이스 환경 필터
  • pc | mo
    • pc: PC 환경
    • mo: 모바일 환경
ages Array<String> 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세 이상
gender String Optional 성별 필터
  • m | f
    • m: 남성
    • f: 여성

keywordGroups

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

필드 타입 필수 여부 설명
groupName String Required 그룹 이름(주제어)
  • 데이터를 조회할 검색어끼리 묶어서 그룹 단위로 통합
keywords String Required 그룹의 검색어 목록
  • 데이터 그룹당 최대 20개 검색어 조회 지원

요청 예시

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

curl --location --request POST 'https://naveropenapi.apigw.gov-ntruss.com/datalab/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": "2024-08-15",
    "endDate": "2024-08-19",
    "timeUnit": "date",
    "keywordGroups": [
        {
            "groupName": "마라탕",
            "keywords": [
                "마라탕",
                "꿔바로우",
                "계란볶음밥"
            ]
        }
    ],    
    "device": "mo",
    "ages": [
        "4",
        "5"
    ],
    "gender": "f"
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 필수 여부 설명
startDate String - 데이터 조회 시작 날짜(yyyy-MM-dd)
  • 2016년 01월 01일부터 조회 가능
endDate String - 데이터 조회 종료 날짜(yyyy-MM-dd)
timeUnit String - 데이터 조회 구간 단위
  • date | week | month
    • date: 일간 데이터 조회
    • week: 주간 데이터 조회
    • month: 월간 데이터 조회
results Array - 그룹 정보

results

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

필드 타입 필수 여부 설명
title String - 그룹 이름(주제어)
keywords String - 그룹의 검색어 목록
data Array - 구간별 정보

data

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

필드 타입 필수 여부 설명
period String - 데이터 조회 구간별 시작 날짜(yyyy-MM-dd)
ratio Integer - 데이터 조회 구간별 검색/클릭 수치 비율
  • 결과 값 중 가장 큰 값을 100으로 설정

응답 상태 코드

Search Trend API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Search Trend 공통 응답 상태 코드를 참조해 주십시오.

응답 예시

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

{
    "startDate": "2024-08-15",
    "endDate": "2024-08-19",
    "timeUnit": "date",
    "results": [
        {
            "title": "마라탕",
            "keywords": [
                "마라탕",
                "꿔바로우",
                "계란볶음밥"
            ],
            "data": [
                {
                    "period": "2024-08-15",
                    "ratio": 100
                },
                {
                    "period": "2024-08-16",
                    "ratio": 84.81543
                },
                {
                    "period": "2024-08-17",
                    "ratio": 88.33892
                },
                {
                    "period": "2024-08-18",
                    "ratio": 97.31543
                }
            ]
        }
    ]
}