Project Management API はプロジェクトを管理（作成・編集・削除）する事ができ、プロジェクトやキーワード別の統計を取得する事ができます。
ユーザーのサイトリスト このメソッドは、ユーザーの全てのプロジェクトのリストを取得する事ができます。
リクエスト フォーマット
GET https://api4.seranking.com/sitesレスポンス例
成功すると、サーバーは 200 HTTP コードを返します。
例
[ 名称 説明 id ユニークサイトID title ウェブサイト名 name ウェブサイトURL group_id ウェブサイトグループID is_active ウェブサイトステータス 1 – active, 0 – delayed exact_url 1 – サブドメインとサブフォルダを除いた特定のURLの順位のみをチェックします subdomain_match 1 – SERP上でサブドメインも考慮する 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コードとプロジェクトの検索エンジンリストを返します。
レスポンス例
[パラメータ:
名称 説明 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 はい 検索エンジン 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} 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を参照）。
結果
I成功すると、サーバーはプロジェクトのキーワード配列とそれらの統計を返します。
名称 説明 id ユニーククエリ ID name キーワード group_id クエリグループ ID link ターゲット URL first_check_date 最初にクエリをチェックした日付
レスポンス例
[統計のサマリ このメソッドはプロジェクトの統計のサマリを取得する事ができます。
リクエスト フォーマット
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のインデックス数
レスポンス例
{キーワードの統計 このメソッドは、指定期間内のプロジェクトのキーワード順位チェックの統計を取得する事ができます。
リクエスト フォーマット
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>
レスポンス例
[ エラー
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 下部広告の合計数
レスポンス例
プロジェクトへのクエリ追加 このメソッドは、プロジェクトに新しいキーワードを追加する事ができます。
リクエスト フォーマット
POST https://api4.seranking.com/sites/{site_id}/keywords リクエスト パラメータ
名称 必須 説明 keyword はい キーワード (クエリ) group_id いいえ キーワードグループ ID (パラメータが指定されていなければ、デフォルトグループが使用されます) target_url いいえ ターゲットリンク/td> is_strict いいえ 指定したターゲットリンクのみの順位をチェック (0 または 1; 0 がデフォルト)
結果
成功すると、サーバーは追加されたキーワードの配列と、プロジェクト IDを返します。
名称 必須 説明 added はい プロジェクトに追加されたクエリの数 ids いいえ 追加されたクエリのIDの配列
レスポンス例
{ エラー
HTTP コード エラーメッセージ 400 No keywords specified
プロジェクトのキーワード変更 このメソッドは、プロジェクト内のキーワード設定を変更する事ができます。
リクエスト フォーマット
PATCH https://api4.seranking.com/api/sites/{site_id}/keywords/{keyword_id}
{
リクエスト パラメータ
名称 説明 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 リクエスト フォーマット
名称 必須 説明 url はい ウェブサイト URL title はい プロジェクト名 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
レスポンス例
プロジェクト設定の変更 このメソッドはプロジェクト設定の変更/更新を行う事ができます。
リクエスト フォーマット
PUT https://api4.seranking.com/sites/{site_id} リクエスト パラメータ
名称 説明 url ウェブサイト URL title プロジェクト名 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 はい ユニーク キーワード 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/パラメータ
名称 必須 説明 site_engine_id いいえ ユニーク プロジェクト 検索エンジン ID。APIリクエストにこのパラメータを含めた場合、順位チェックは指定された検索エンジンのみで行われます。 keywords はい 順位チェックを行うキーワードごとの配列。キーワードごとに指定できます:: site_engine_id (ユニーク プロジェクト 検索エンジン ID) と keyword_id (ユニーク キーワード ID)。APIリクエストにこのパラメータが含まれていると、 site_engine_id パラメータは無視されます。
結果
成功すると、サーバーは順位チェックが行われたキーワードの配列を返します。
名称 必須 説明 total はい 順位チェックが実施されたキーワードの数
レスポンス例
エラー
HTTP コード エラーメッセージ 400 Unknown site_engine_id