キーワード調査

キーワードデータ取得

説明

本メソッドはキーワードに関する様々なデータを取得できます。

リクエスト フォーマット

POST https://api4.seranking.com/research/{source}/analyze-keywords/

パラメータ

名前 必須 説明
sourceはいリクエストされるデータベース
keywordsはい分析するキーワード。1件のリクエストにつき最大5,000件まで分析。
sort いいえソート基準 (標準ではCPC)
sort_order いいえソート順 (昇順 または 標準では降順)
colsいいえ返される値のリスト (カンマ区切り))

結果

成功すると、サーバーはキーワードのリストをパラメータとともに返します。

[

 {

      is_data_found: true,

      keyword: “seranking.com”,

      volume: 10,

      cpc: 0.00,

      competition: “0.00”,

      difficulty: 90,

      history_trend: {

            “2020-03-01”: 10,

            “2020-04-01”: 10,

            “2020-05-01”: 10,

            “2020-06-01”: 10,

            “2020-07-01”: 10,

            “2020-08-01”: 10,

            “2020-09-01”: 10,

            “2020-10-01”: 10,

            “2020-11-01”: 10,

            “2020-12-01”: 10,

            “2021-01-01”: 10,

            “2021-02-01”: 10

      }

},

…

]

レスポンス パラメータ

名前 説明
is_data_foundキーワード id データが検知されたかどうか示します。: 値は true または false
keywordキーワード
volume検索ボリューム
cpcCPC
competition競合性
difficultyキーワード難易度
history_trend検索ボリューム履歴

エラー

HTTP コード エラー メッセージ
400Incorrect order field {sort} {sort_order}
400Number of keywords exceeded. Max keywords per single request: 10000
400Invalid keywords
400Invalid source