プロジェクト/サイト管理

Project Management API はプロジェクトを管理（作成・編集・削除）する事ができ、プロジェクトやキーワード別の統計を取得する事ができます。

ユーザーのサイトリスト

このメソッドは、ユーザーの全てのプロジェクトのリストを取得する事ができます。

リクエストフォーマット

GET https://api4.seranking.com/sites

レスポンス例

成功すると、サーバーは 200 HTTP コードを返します。

例

[

{

  “id”: 1,

  “title”: “zniqpf tfallp mykqeg”,

  “name”: “Cronin.info”,

  “group_id”: 0,

  “is_active”: 1,

  “exact_url”: 0,

  “subdomain_match”: 0,

  “depth”: 100,

  “check_freq”: “check_daily”,

  “check_day”: null,

  “guest_link”: “https://seranking.com/guest.html?site_id=1&hv=0&hash=432&tab=detailed”,

  “keyword_count”: 0,

}

]

名称	説明
id	ユニークサイトID
title	ウェブサイト名
name	ウェブサイトURL
group_id	ウェブサイトグループID
is_active	ウェブサイトステータス 1 – active, 0 – delayed
exact_url	1 – サブドメインとサブフォルダを除いた特定のURLの順位のみをチェックします
subdomain_match	1 – SERP上でサブドメインも考慮する
depth	順位収集の深度（範囲)
check_freq	チェック頻度
check_day	週毎のチェック頻度（check_weekly）の場合、このパラメータは曜日が示されます。 (1 – 月曜日から 7 –日曜日) 月毎のチェック頻度（check_monthly）の場合、このパラメータは日付が示されます。 (1 – 31)
guest_link	サイトの統計を認証無しで閲覧可能なゲストリンク
keyword_count	プロジェクトに追加されたキーワード数

サイトの検索エンジンリスト

このメソッドはプロジェクトで指定されている検索エンジンリストを取得する事ができます。

リクエストフォーマット

GET https://api4.seranking.com/sites/{site_id}/search-engines

結果

成功すると、サーバーは200HTTPコードとプロジェクトの検索エンジンリストを返します。

レスポンス例

[

{

   «site_engine_id»: 1,

   «search_engine_id»: 339,

  «region_id»: 0,

  «region_name»: null,

  «lang_code»: «ru»,

  «merge_map»: 0,

  «business_name»: null,

  «phone»: null,

  «paid_results»: 0,

  «featured_snippet»: 0,

  «keyword_count»: 10,

}

]

パラメータ:

名称	説明
search_engine_id	検索エンジン ID (GET /system/search-engines を参照)
region_id	Region ID。Yandexのみ (GET /system/yandex-regions を参照)
region_name	リージョン。Googleのみ対応 (次を参照 GET /system/google-regions)
lang_code	言語コード (/system/google-langs を参照)
merge_map	Googleマップ検索結果を考慮する。 0 – 考慮しない, 1 –考慮する, 2 – 考慮して個別に表示する
business_name	Googleマップ検索結果のビジネス名
phone	Googleマップ検索結果の会社電話番号
paid_results	Google 広告の順位追跡 (1 – はい, 0 – いいえ)
featured_snippet	強調スニペットを考慮する (1 – 考慮する, 0 –考慮しない)

エラー

HTTP コード	エラーメッセージ/th>
400	Invalid keyword_id
400	Invalid date
400	No ids in request
404	Unknown search_engine_id
404	Unknown site_engine_id

プロジェクトへの検索エンジン追加

このメソッドは、プロジェクトに検索エンジンを新たに追加する事ができます。

リクエストフォーマット

POST https://api4.seranking.com/sites/{site_id}/search-engines

例

{

  “search_engine_id”: 339,

  “region_id”: 0,

  “region_name”: null,

  “lang_code”: “ru”,

  “merge_map”: 0,

  “business_name”: null,

  “phone”: null,

  “paid_results”: 0,

  “featured_snippet”: 0

}

パラメータ:

名称	必須	説明
search_engine_id	はい	検索エンジン ID (GET /system/search-engines を参照)
region_id	いいえ	Region ID。Yandexのみ (GET /system/yandex-regions を参照)
region_name	いいえ	英語の地域名 (region / city)。Googleのみ
lang_code	いいえ	言語コード (/system/google-langs を参照)
merge_map	いいえ	Googleマップ検索結果を考慮する。 0 – 考慮しない, 1 –考慮する, 2 – 考慮して個別に表示する
business_name	いいえ	Googleマップ検索結果のビジネス名
phone	いいえ	Googleマップ検索結果の会社電話番号
paid_results	いいえ	Google 広告の順位追跡 (1 – はい, 0 – いいえ)
featured_snippet	いいえ	強調スニペットを考慮する (1 – 考慮する, 0 –考慮しない)

結果

成功すると、サーバーは201 HTTPコードと、追加された検索エンジンの site_engine_id を返します。

エラー

HTTP コード	エラーメッセージ
404	Unknown search_engine_id

プロジェクトの検索エンジン変更

このメソッドは、プロジェクトに検索エンジンを新たに追加する事ができます。

リクエストフォーマット

PUT https://api4.seranking.com/sites/{site_id}/search-engines/{site_engine_id}

{

  “region_id”: 0,

  “region_name”: null,

  “lang_code”: “ru”,

  “merge_map”: 0,

  “business_name”: null,

  “phone”: null,

  “paid_results”: 0,

  “featured_snippet”: 0

}

Parameters

パラメータ – プロジェクトへの検索エンジン追加を参照してください。

結果

成功するとサーバーは200 HTTPコードを返します。

プロジェクトの検索エンジン削除

リクエストフォーマット

DELETE https://api4.seranking.com/sites/{site_id}/search-engines/{site_engine_id}

結果

成功すると、サーバーは204 HTTPコードを返します。

ウェブサイトのキーワードリスト

このメソッドは、特定のプロジェクトのターゲットページに関するキーワードリストを取得する事ができます。

リクエストフォーマット

GET https://api4.seranking.com/sites/{site_id}/keywords?site_engine_id=NNN

リクエストパラメータ

名称	説明
search_engine_id	任意のパラメータ。検索エンジン ID（GET /system/search-enginesを参照）。これが渡されると、first_check_dateが返されます。

結果

I成功すると、サーバーはプロジェクトのキーワード配列とそれらの統計を返します。

名称	説明
id	ユニーククエリ ID
name	キーワード
group_id	クエリグループ ID
link	ターゲット URL
first_check_date	最初にクエリをチェックした日付

レスポンス例

[

    {

        “id”: “1”,

        “name”: “key1”,

        “group_id”: “2”,

        “link”: null,

        “first_check_date”: “2015-02-17”,

        “tags”: [

            “11”,

            “12”

        ]

    },

    {

        “id”: “2”,

        “name”: “key2”,

        “group_id”: “2”,

        “link”: “http://mysite.com/”,

        “first_check_date”: null,

        “tags”: []

    },

    …

]

統計のサマリ

このメソッドはプロジェクトの統計のサマリを取得する事ができます。

リクエストフォーマット

GET https://api4.seranking.com/sites/{site_id}/stat

結果

名称	説明
site_id	ユニークウェブサイト ID
today_avg	最新の順位チェック日(今日)の平均順位
yesterday_avg	前回の順位チェック日(昨日)の平均順位
total_up	順位上昇の合計数
total_down	順位下降の合計数
process	ウェブサイト順位の現時点での処理度合（パーセント）
top5	TOP 5以内のキーワード
top10	TOP 10以内のキーワード
top30	TOP 30以内のキーワード
visibility	トラフィック予測値
visibility_percent	ヴィジビリティ(%表示)
index_yandex	Yandexのインデックス数
yandex_x	Yandex X
index_google	Googleのインデックス数

レスポンス例

{

        “site_id”: 123,

        “name”: “site1.com”,

        “group_id”: null,

        “title”: “my site”,

        “today_avg”: 123,

        “yesterday_avg”: 111,

        “total_up”: 0,

        “total_down”: 5,

        “process”: “99.9”,

       “top5” : 1,

        “top10” : 2,

        “top30” : 3,

        “visibility” : 2,

        “visibility_percent” : 30.0,

        “da” : 4,

        “index_yandex” : 100,

        “index_google” : 200,

       “index_x” : null,

    }

キーワードの統計

このメソッドは、指定期間内のプロジェクトのキーワード順位チェックの統計を取得する事ができます。

リクエストフォーマット

GET https://api4.seranking.com/sites/{site_id}/positions?date_from=2018-01-01&date_to=2018-01-07&site_engine_id=1&with_landing_pages=1&with_serp_features=1

パラメータ

クエリのパラメータです。全てのパラメータは任意です。

名称	形式	説明
date_from	yyyy-mm-dd	期間の開始日 (デフォルトでは今日から一週間前)
date_to	yyyy-mm-dd	期間の終了日 (デフォルトでは今日)
site_engine_id		検索エンジン ID。指定されていなければ、全ての検索エンジンのデータが返されます。
in_top		順位で絞込。例えば、in_top=10 は指定した期間で最後にチェックされたTOP 10以内のキーワードのみが返されます。
with_landing_pages		検索結果のページのURL情報
with_serp_features		キーワード検索結果で検知されたGoogle SERPの特徴。

結果

成功すると、サーバーは指定した期間内のキーワード統計を含めてプロジェクトの全ての（または指定された）検索エンジンの配列を返します。

名称	説明
id	ユニーククエリ ID
positions	要素の配列
date	日付
change	前回の日付と比較した順位の差 (マイナスもあり得ます)
pos	現在の順位
is_map	順位が掲載された場所を示します; 0 値は自然検索結果, 1 は地図ブロック
map_position	“オーガニックとマップ検索結果を別々に集計”オプションが利用可(merge_map = 2)の状態における地図ブロックの順位
paid_position	Google検索結果の広告順位
landing_pages	要素の配列 date – yyyy-mm-dd 形式の日付 url – キーワードごとの検索結果のページURL
features	要素の配列。値が true なら、プロジェクトのウェブサイトのリンクを含みます
volume	検索ボリューム
competition	競合性
suggested_bid	CPC(Cost per click)
kei	KEI(Keyword Efficiency Index)
results	指定キーワードのGoogle検索結果数
total_sum	成果報酬レポート設定で算出されるキーワードごとの費用/td>

レスポンス例

[

    {

        “site_engine_id”: 1,

        “keywords”: [

            {

                “id”: “12”,

                “positions”: [

                    {

                        “date”: “2017-12-19”,

                        “pos”: 18,

                        “change”: 0,

                        “price”: 0,

                        “is_map”: 0,

                        “map_position”: 0,

                        “paid_position”: 0

                    }

                ],

                “volume”: 390,

               “competition”: 3,

               “suggested_bid”: 1,

               “kei”: 1,

               “resultsi”: 100,

               “total_sum”: 0,

                “landing_pages”: [

                    {

                        “url”: “https://domain.com/page.html”,

                        “date”: “2017-12-14”

                    }

                ],

                “features”: {

                    “tads”: true,

                    “knowledge_graph”: true,

                    “images”: true,

                    “sitelinks”: true,

                    “reviews”: false

                },

            },

   …

]

エラー

HTTP コード	エラーメッセージ
404	Invalid site_engine_id

広告の合計数

このメソッドは、日別の上部・下部広告の合計数のデータを取得します。

リクエストフォーマット

 GET https://api4.seranking.com/sites/{site_id}/ads?date_from=2020-05-20&date_to=2020-05-21&site_engine_ids[]=1&site_engine_ids[]=2&keywords_ids[]=1&keywords_ids[]=1

パラメータ

クエリパラメータです。全てのパラメータは任意で選択できます。

名称	タイプ	説明
date_from	yyyy-mm-dd	期間指定の開始日 (標準では今日から1週間前の日)
date_to	yyyy-mm-dd	期間指定の終了日 (標準では今日)
site_engine_ids		検索エンジン ID フィルタ用です。指定されていない場合は、全ての検索エンジンのデータが返されます。
keywords_ids		キーワード ID フィルタ用です. 指定されていない場合は、全てのキーワードのデータが返されます。

結果

成功すると、サーバーは該当するプロジェクトの全ての(または指定した)検索エンジンからのデータの配列を返します。この配列には指定した期間の日別の全ての（または指定した）キーワードに関する検索結果の上・下広告の数のデータを含みます。

最大で100,000 件の結果を返します。該当するプロジェクトでキーワード数が多すぎる場合には、検索エンジンやキーワードのIDや期間を指定してデータを絞り込む事をおすすめします。

名称	説明
site_engine_id	検索エンジンID
keywords	キーワードと広告数のデータ配列
id	キーワード ID
ads	日別の広告数のデータ配列
date	日付
tabs	上部広告の合計数
bads	下部広告の合計数

レスポンス例



[{

  “site_engine_id”: 1,

  “keywords”: [

    {

      “id”: 1,

      “ads”: [

        {

          “date”: “2020-05-20”,

          “tads”: 2,

          “bads”: 3

        },

        {

          “date”: “2020-05-21”,

          “tads”: 3,

          “bads”: 2

        },

      ]

    },

    {

      “id”: 2,

      “ads”: [

        {

          “date”: “2020-05-20”,

          “tads”: 0,

          “bads”: 0

        },

        {

          “date”: “2020-05-21”,

          “tads”: 0,

          “bads”: 1

        },

      ]

    },

  ]

},

{

  “site_engine_id”: 2,

  “keywords”: [

    {

      “id”: 1,

      “ads”: [

        {

          “date”: “2020-05-20”,

          “tads”: 1,

          “bads”: 1

        },

        {

          “date”: “2020-05-21”,

          “tads”: 2,

          “bads”: 2

        },

      ]

    },

    {

      “id”: 2,

      “ads”: [

        {

          “date”: “2020-05-20”,

          “tads”: 0,

          “bads”: 2

        },

        {

          “date”: “2020-05-21”,

          “tads”: 5,

          “bads”: 1

        },

      ]

    },

  ]

}]

プロジェクトへのクエリ追加

このメソッドは、プロジェクトに新しいキーワードを追加する事ができます。

リクエストフォーマット

POST https://api4.seranking.com/sites/{site_id}/keywords

[{

“keyword”:”text”,

“group_id”:1,

“target_url”: “http://site.com/”,

“is_strict”: 0,

“site_engine_ids”: [20,21]

}]

リクエストパラメータ

名称	必須	説明
keyword	はい	キーワード (クエリ)
group_id	いいえ	キーワードグループ ID (パラメータが指定されていなければ、デフォルトグループが使用されます)
target_url	いいえ	ターゲットリンク/td>
is_strict	いいえ	指定したターゲットリンクのみの順位をチェック (0 または 1; 0 がデフォルト)

結果

成功すると、サーバーは追加されたキーワードの配列と、プロジェクト IDを返します。

名称	必須	説明
added	はい	プロジェクトに追加されたクエリの数
ids	いいえ	追加されたクエリのIDの配列

レスポンス例

{

    “added”: 3,

    “ids”: [

        123,

        456,

        789

    ]

}

エラー

HTTP コード	エラーメッセージ
400	No keywords specified

プロジェクトのキーワード変更

このメソッドは、プロジェクト内のキーワード設定を変更する事ができます。

リクエストフォーマット

PATCH https://api4.seranking.com/api/sites/{site_id}/keywords/{keyword_id}
{

“keyword”:”text”,

“target_url”: “http://site.com/”

}

リクエストパラメータ

名称	説明
keyword	キーワード (検索クエリ)
group_id	別のプロジェクトキーワードグループにキーワードを移行する際のキーワードグループID (プロジェクトキーワードグループ IDのリストからの値を使用します)
target_url	対象リンク
is_strict	特定の対象リンクのみの順位をチェック (0 または 1 で 0 はデフォルトオプション)

結果

成功すると、サーバーは200 HTTPコードを返します。

エラー

HTTP コード	エラーメッセージ
400	Invalid or empty keyword data
403	Access denied (wrong site_id)
404	Unknown keyword (wrong keyword_id)

プロジェクトの追加

このメソッドはユーザーアカウントに新しいプロジェクトを追加する事ができます。

リクエストフォーマット

POST https://api4.seranking.com/sites

[{

“utl”:”http://test.site/”,

“title”:”seo site”

}]

リクエストフォーマット

名称	必須	説明
url	はい	ウェブサイト URL
title	はい	プロジェクト名
depth	いいえ	順位収集の深度 (100, 200), 100がデフォルト
match_mode	はい	見つかったURLの検証タイプ : domain, subdomain, exact, path
check_freq	いいえ	順位チェック頻度 (‘check_daily’,’check_1in3′,’check_weekly’, ‘check_monthly’, ‘manual’), check_daily がデフォルト
auto_reports	いいえ	週次レポート？ (0 または 1), 1 がデフォルト
site_group_id	いいえ	新規追加されたプロジェクトのグループ ID
check_day	いいえ	週毎のチェック頻度（check_weekly）の場合、このパラメータは曜日が示されます。 (1 – 月曜日から 7 –日曜日) 月毎のチェック頻度（check_monthly）の場合、このパラメータは日付が示されます。 (1 – 31)
is_active	いいえ	プロジェクトステータス 1 – active, 0 – delayed

結果

成功すると、サーバーは 201 HTTP コードとアカウントに追加されたプロジェクトの ID を返します。

名称	必須	説明
site_id	はい	アカウントに追加されたプロジェクトのID

レスポンス例

{

    “site_id”: 507052

}

プロジェクト設定の変更

このメソッドはプロジェクト設定の変更/更新を行う事ができます。

リクエストフォーマット

PUT https://api4.seranking.com/sites/{site_id}

{

“title”:”new site title”

}

リクエストパラメータ

名称	説明
url	ウェブサイト URL
title	プロジェクト名
depth	順位収集の深度 (100, 200), 100がデフォルト
match_mode	検索結果で見つかったURLの一致タイプ : domain, subdomain, exect, path
check_freq	順位チェック頻度 (‘check_daily’,’check_1in3′,’check_weekly’, ‘check_monthly’, ‘manual’), check_daily がデフォルト
site_group_id	新規追加されたプロジェクトのグループ ID
check_day	週毎のチェック頻度（check_weekly）の場合、このパラメータは曜日が示されます。 (1 – 月曜日から 7 –日曜日) 月毎のチェック頻度（check_monthly）の場合、このパラメータは日付が示されます。 (1 – 31)
is_active	プロジェクトステータス 1 – active, 0 – delayed

結果

成功すると、サーバーは 200 HTTP コードを返します。

プロジェクトの削除

このメソッドはユーザーアカウントからプロジェクトを削除する事ができます。

リクエストフォーマット

DELETE https://api4.seranking.com/sites/{site_id}

結果

成功すると、サーバーは 204 HTTP コードを返します。

キーワードの削除

このメソッドはプロジェクトからキーワードを削除する事ができます。

リクエストフォーマット

DELETE https://api4.seranking.com/sites/{site_id}/keywords?keywords_ids[]=1&keywords_ids[]=2&keywords_ids[]=3

リクエストパラメータ

名称	必須	説明
keywords_ids	はい	削除するキーワードのIDの配列

結果

成功すると、サーバーは 204 HTTP コードを返します。

エラー

HTTP コード	エラーメッセージ/th>
400	No ids in request

手動順位設定

このメソッドはプロジェクトのキーワード順位を設定する事ができます。

リクエストフォーマット

PUT https://api4.seranking.com/sites/{site_id}/position/

{

    “keyword_id”: 1,

    “date”: “2018-01-01”,

    “position”:100,

    “site_engine_id”: 1

}

リクエストパラメータ

名称	必須	タイプ	説明
keyword_id	はい		ユニークキーワード ID (GET https://api4.seranking.com/sites/{site_id}/keywords を参照)
date	はい	yyyy-mm-dd	設定される順位の日付
site_engine_id	はい		ユニークプロジェクト検索エンジン ID ( GET https://api4.seranking.com/sites/{site_id}/search-engines を参照)
position	はい		0 から 200までの順位。 0 は “not found” とみなされます

結果

成功すると、サーバーは 200 HTTP コードを返します。

エラー

HTTP コード	エラーメッセージ
400	Invalid date
400	Invalid keyword_id
400	Unknown site_engine_id

順位チェックの実行

このメソッドは、プロジェクト全体、または特定のキーワードの順位チェックを実行します。

リクエストフォーマット

POST https://api4.seranking.com/api/sites/{site_id}/recheck/

{

 “keywords”:[

   {

      “site_engine_id”:1,

      “keyword_id”:2

   }

 ]

}

パラメータ

名称	必須	説明
site_engine_id	いいえ	ユニークプロジェクト検索エンジン ID。APIリクエストにこのパラメータを含めた場合、順位チェックは指定された検索エンジンのみで行われます。
keywords	はい	順位チェックを行うキーワードごとの配列。キーワードごとに指定できます:: site_engine_id (ユニークプロジェクト検索エンジン ID) と keyword_id (ユニークキーワード ID)。APIリクエストにこのパラメータが含まれていると、 site_engine_id パラメータは無視されます。

結果

成功すると、サーバーは順位チェックが行われたキーワードの配列を返します。

名称	必須	説明
total	はい	順位チェックが実施されたキーワードの数

レスポンス例

{

    “total”: 5

}

エラー

HTTP コード	エラーメッセージ
400	Unknown site_engine_id

プロジェクト/サイト 管理

ユーザーのサイトリスト

サイトの検索エンジンリスト

プロジェクトへの検索エンジン追加

プロジェクトの検索エンジン変更

プロジェクトの検索エンジン削除

ウェブサイトのキーワードリスト

統計のサマリ

キーワードの統計

広告の合計数

プロジェクトへのクエリ追加

プロジェクトのキーワード変更

プロジェクトの追加

プロジェクト設定の変更

プロジェクトの削除

キーワードの削除

手動順位設定

順位チェックの実行

プロジェクト/サイト管理