キーワード年齢別トレンドの照会

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

ショッピングインサイト APIは、NAVER DataLabのショッピングインサイトデータを照会する RESTful APIです。NAVER統合検索のショッピングエリアおよびNAVERショッピングで、特定のショッピング分野と検索キーワードにおける検索クリック数の推移を、ユーザーの年齢別に確認することができます。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
POST	/shopping/v1/category/keyword/age

リクエストヘッダ

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`	String	Required	ショッピング分野のコード NAVERショッピングでカテゴリを選択した際、URLの`cat_id`パラメータの値で確認
`keyword`	String	Required	検索キーワード
`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才以上デフォルト: 全年齢

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST https://naverapihub.apigw.ntruss.com/shopping/v1/category/keyword/age
--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": "50000000",
    "keyword": "スーツ",
    "device": "pc",
    "gender": "f"
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`startDate`	String	-	照会期間の開始日 (`yyyy-mm-dd`)
`endDate`	String	-	照会期間の終了日 (`yyyy-mm-dd`)
`timeUnit`	String	-	区間単位
`results`	Array	-	照会結果リスト: results

results

resultsの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`title`	String	-	検索キーワードグループの名前
`keyword`	Array	-	検索キーワード
`data`	Array	-	区間別クリック数の推移データ: data

data

dataの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`period`	String	-	区間別開始日 (`yyyy-mm-dd`)
`group`	String	-	検索ユーザーの年齢 `10` \| `20` \| `30` \| `40` \| `50` \| `60` `10`: 10~19才 `20`: 20~29才 `30`: 30~39才 `40`: 40~49才 `50`: 50~59才 `60`: 60才以上
`ratio`	Number	-	区間ごとのクリック数の相対的な割合区間ごとの結果のうち、最も大きな値を100として設定した相対値

レスポンスステータスコード

NAVER API HUBで共通して使用されるレスポンスステータスコードの詳細は、NAVER API HUBのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "startDate": "2023-11-01",
    "endDate": "2023-11-07",
    "timeUnit": "date",
    "results": [
        {
            "title": "スーツ",
            "keyword": [
                "スーツ"
            ],
            "data": [
                {
                    "period": "2023-11-01",
                    "ratio": 18.18181,
                    "group": "20"
                },
                {
                    "period": "2023-11-01",
                    "ratio": 18.18181,
                    "group": "30"
                },
                {
                    "period": "2023-11-01",
                    "ratio": 36.36363,
                    "group": "40"
                },
                {
                    "period": "2023-11-01",
                    "ratio": 9.0909,
                    "group": "50"
                }
            ]
        }
    ]
}

Documentation Index