API

被リンクグループ

被リンクグループのリストを取得

このメソッドは、被リンクグループのリストと数を取得する事ができます

リクエスト フォーマット

コピー
GET /backlink-groups/{site_id}

リクエスト パラメータ

名称必須説明
site_idYesウェブサイト ID

結果

成功すると、サーバーは被リンクグループのリストと数を返します。

レスポンス例

コピー
{
"total_groups": 2,
"groups": [
{
"id": 1,
"name": "General",
"count": 5
},
{
"id": 2,
"name": "Second group",
"count": 1
}
]
}

レスポンス パラメータ

名称説明
total_groups合計グループ数
groupsグループの配列
idグループ ID
nameグループ名
countグループの被リンク数

エラー

HTTP コードエラー メッセージ
403アクセスが拒否されました (wrong site_id)

被リンクのグループ作成

このメソッドは、ウェブサイト被リンクのグループを作成する事ができます。

リクエスト フォーマット

コピー
POST /backlink-groups/{site_id}
{
"name": "Group name"
}

リクエスト パラメータ

名称必須説明
site_idYesウェブサイト ID
nameYesグループ名

結果

成功すると、サーバーは被リンクグループIDを返します。

レスポンス例

コピー
{
"group_id": 2
}

レスポンス パラメータ

名称説明
group_id被リンクグループ ID

エラー

HTTP コードエラー メッセージ
403アクセスが拒否されました (wrong site_id)
400無効な名称
400グループは既に存在します

被リンクグループの削除

このメソッドは、ウェブサイト被リンクのグループを削除する事ができます。

リクエスト フォーマット

コピー
DELETE /backlink-groups/{site_id}?id={id}

リクエスト パラメータ

名称必須説明
site_idYesウェブサイト ID
idYes被リンクグループ ID

結果

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

エラー

HTTP コードエラー メッセージ
403アクセスが拒否されました (wrong site_id)
400無効なグループID
400グループは存在しません

被リンクグループの名前変更

このメソッドは被リンクグループの名称を変更する事ができます。

リクエスト フォーマット

コピー
PUT /backlink-groups/{site_id}
{
"id": 2,
"name": "New group name"
}

リクエスト パラメータ

名称必須説明
site_idYesウェブサイト ID
idYes被リンクグループ ID
nameYes新しい被リンクグループ名

結果

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

エラー

HTTP コードエラー メッセージ
403アクセスが拒否されました (wrong site_id)
400無効な名称
400グループは既に存在します

被リンクを別のグループに移動

このメソッドは、あるグループから被リンクを別のグループに移す事ができます。

リクエスト フォーマット

コピー
POST /backlink-groups/{site_id}/move
{
"id": 1,
"backlink_ids": [1],
"group_ids": [2]
}

リクエスト パラメータ

名称必須説明
site_idYesウェブサイト ID
idYes移動先の被リンクグループ ID
backlink_idsNo移動される被リンク ID の配列
group_idsNo移動される被リンクグループ ID の配列

結果

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

エラー

HTTP コードエラー メッセージ
403アクセスが拒否されました (wrong site_id)
400無効なグループID
400被リンクグループID
400グループIDまたは被リンクは必須です

Learn how SE Ranking’s API can boost your SEO!

Hi! Meet our product expert, Alex.

He’ll walk you through the API and show you how to get the most out of it.

  • Enjoy a tailored demo on integrating rich, structured SEO data into your stack.
  • Pin down every tech detail live—auth, endpoints, rate limits, data formats.
  • Compare usage tiers and pricing so you can unlock maximum data value.

無料デモをリクエスト 当社のツールと連携機能の実際の動作をご覧ください

このボタンをクリックすると、SEランキングの利用規約プライバシーポリシーに同意したことになります。