キーワード調査
キーワードデータ取得
説明
本メソッドはキーワードに関する様々なデータを取得できます。
リクエスト フォーマット
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 | 検索ボリューム |
cpc | CPC |
competition | 競合性 |
difficulty | キーワード難易度 |
history_trend | 検索ボリューム履歴 |
エラー
HTTP コード | エラー メッセージ |
400 | Incorrect order field {sort} {sort_order} |
400 | Number of keywords exceeded. Max keywords per single request: 10000 |
400 | Invalid keywords |
400 | Invalid source |