一般的なデータ

検索エンジンのリスト

このメソッドは、順位追跡の為にプロジェクトに追加された、地域指定を含む利用可能な検索エンジンのリストを取得する事ができます。

リクエスト フォーマット

GET /system/search-engines

結果

成功すると、サーバーは利用可能な検索エンジンの配列を返します。

名称 説明
id ユニーク 検索エンジン ID
name 名前
region_id リージョン ID
type 検索エンジンの種類

レスポンス例

[
{
“id”: “200”,
“name”: “Google USA”,
“regionid”: “182”
},
{
“id”: “201”,
“name”: “Google Andorra”,
“regionid”: “4”
},
{
“id”: “202”,
“name”: “Google United Arab Emirates”,
“regionid”: “178”
},

]

Yandexで利用可能な地域のリスト

このメソッドは、Yandex 検索エンジンで利用可能な言語の完全なリストを取得する事ができます。

リクエスト フォーマット

GET /system/yandex-regions

結果

成功すると、サーバーはYandexの地域のリストとそのユニーク IDを含む配列を返します。

レスポンス例

{
“1”: “Moscow”,
“2”: “Saint-Petersburg”,
“3”: “Centre”,
“4”: “Belgorod”,
“5”: “Ivanovo”,

“122068”: “Ambrolauri”,
“122069”: “Zugdidi”,
“122070”: “Akhaltsikhe”,
“123580”: “Tedzhen”
}

Googleで利用可能なリージョンのリスト

説明

このメソッドは、Google検索エンジンで利用可能なリージョン(地域)のリストを取得する事ができます。

リクエスト フォーマット

GET /system/google-regions

結果

成功すると、サーバーはGoogleのリージョンリストの配列を返します。

レスポンス例

[
{ “name”: “Kabul, Kabul, Afghanistan”, “region_id”: 1 }
,
…]

Googleの言語リスト

このメソッドは、Google 検索エンジンで利用可能な言語の完全なリストを取得する事ができます。

リクエスト フォーマット

GET /system/google-langs

結果

成功すると、サーバーはGoogle 検索エンジンの言語コードとその名称の完全なリストの配列を返します。

名称 必須 説明
lang_code はい 言語コード
name はい L言語名

レスポンス例

[
“de”:”Deutsch”,
“en”:”English”,
“es”:”español”

]

検索ボリューム取得可能な地域のリスト

このメソッドは、SE Rankingがキーワード検索ボリュームのチェックを実行できる全地域のリストを取得する事ができます。

パラメータ

このメソッドにはパラメータはありません。

リクエスト フォーマット

GET /system/volume-regions

結果

成功すると、サーバーは地域の配列を返します。

名称 必須 説明
id はい ユニーク リージョン ID
name いいえ L言語名

レスポンス例

[
{
“id”: “180”,
“name”: “United Kingdom”,
“name_ru”: “United Kingdom”,
“ordr”: “1890”,
“code”: “GB”,
“show_in_list”: “1”
},
{
“id”: “182”,
“name”: “USA”,
“name_ru”: “USA”,
“ordr”: “10”,
“code”: “US”,
“show_in_list”: “1”
},

]

キーワード 検索ボリューム データの取得

このメソッドは指定した地域に関するキーワードリストの検索ボリュームデータを取得する事ができます.

パラメータ

名称 必須 説明
region_id はい リージョン ID。 全ての リージョン と その IDを /system/volume-regions 経由で取得できます。
keyword はい 検索ボリュームを取得するキーワードの配列。URL内のキリル文字のキーワードはURLエンコードされている必要があります。例えばそのキーワードは %D0%BA%D0%BB%D1%8E%D1%87 のように変換されます。 配列には最大10単語含める事ができます。
yandex_region_code いいえ WordstatのReigion コード (必須パラメータではありません; 指定された場合、Yandex Wordstatの検索ボリュームが示されます。指定されない場合はGoogleのボリュームが表示されます。)

リクエスト フォーマット

GET /system/volume?regionid=12&keyword[]=%D0%BA%D0%BB%D1%8E%D1%87

結果

成功すると、サーバーは検索ボリュームとともにキーワードの配列を返します。

名称 必須 説明
volume はい キーワード検索ボリューム

レスポンス例

{
“key1”: “1000”,
“key2”: “10000”

“keyN”: “100000”
}

エラー

HTTP コード エラーメッセージ
400 Not enough params. region_id and keyword required
400 Incorrect region_id
404 No data