search

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

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

요청

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

요청 헤더

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

요청 바디

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

keywordGroups

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

요청 예시

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

curl --location --request POST 'https://naveropenapi.apigw.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"
}'

응답

응답 형식을 설명합니다.

응답 바디

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

results

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

data

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

응답 상태 코드

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
                }
            ]
        }
    ]
}