search

Classic/VPC環境で利用できます。

テーマグループに対する NAVER統合検索の期間別トレンドデータ統計を年齢、性別、検索環境別に分析して 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
                }
            ]
        }
    ]
}