API
一般的なデータ
検索エンジンのリスト
このメソッドは、順位追跡の為にプロジェクトに追加された、地域指定を含む利用可能な検索エンジンのリストを取得する事ができます。
リクエスト フォーマット
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 |
