API Description

被リンクチェッカー (ツール)

レポートのリスト

このメソッドは全ての被リンクレポートのリストを取得する事ができます。

リクエストフォーマット

Title of the code block

コピー

GET /backlink-reports?limit=100&offset=0&query=host

リクエストパラメータ

名称	必須	説明
limit	No	レポート数
offset	No	オフセット値
query	No	検索文字列

結果

成功すると、サーバーは被リンクチェッカーツールからの被リンクレポートリストと、合計レポート数を返します。

レスポンス例

Title of the code block

コピー

{

    "total_reports": 6,

    "reports": [

        {

            "id": "11",

            "target": "goods.ru",

            "mode": "host",

            "backlinks": "402717",

            "refdomains": "2264",

            "created": "2021-10-06 13:03:20"

        },

        {

            "id": "9",

            "target": "gismeteo.by",

            "mode": "host",

            "backlinks": "10829727",

            "refdomains": "2211",

            "created": "2021-10-06 10:03:28"

        },

        {

            "id": "7",

            "target": "travelbama.com",

            "mode": "domain",

            "backlinks": "785",

            "refdomains": "199",

            "created": "2021-10-06 09:56:05"

        },

        {

            "id": "6",

            "target": "seranking.ru",

            "mode": "domain",

            "backlinks": "66160",

            "refdomains": "1002",

            "created": "2021-10-06 09:55:19"

        },

        {

            "id": "5",

            "target": "seranking.com",

            "mode": "domain",

            "backlinks": "425573",

            "refdomains": "5682",

            "created": "2021-10-06 09:52:10"

        },

        {

            "id": "4",

            "target": "niab.by",

            "mode": "domain",

            "backlinks": "9709",

            "refdomains": "261",

            "created": "2021-10-06 09:47:51"

        }

    ]

}

レスポンスパラメータ

名称	説明
total_reports	合計レポート数
reports	レポートの配列
id	レポート ID
target	URL、被リンク検索対象
mode	host \| domain \| url
backlinks	URLに関する合計被リンク数
refdomains	URLに関する参照ドメイン数合計
created	レポート作成日と時刻

新しいレポートデータ

このメソッドでは、新しい被リンクレポートデータとレポート作成に関してアカウントから引き落とされた金額を取得する事ができます。

リクエストフォーマット

Title of the code block

コピー

GET /backlink-reports/info?mode=host&target=hh.ru

リクエストパラメータ

名称	必須	説明
mode	Yes	domain \| host \| url
target	Yes	ドメインまたは正確なURL

結果

成功すると、サーバーは新しい被リンクレポートデータと、レポート作成に関してアカウントから引き落とされる金額が返されます。

レスポンス例

Title of the code block

コピー

{

    "backlinks": 12750493,

    "domains": 56528,

    "price": {

        "amount": 0.6,

        "currency": "USD"

    },

    "note": "Note that only the first 10000 backlinks will be shown."

}

レスポンスパラメータ

名称	説明
backlinks	サイトの合計被リンク数
domains	サイトに関する合計ドメイン数
amount	レポート作成に関してアカウントから引き落とされる金額
currency	通貨
note	注意事項

エラー

HTTP コード	エラーメッセージ
400	無効なURL
400	無効なドメイン
400	無効なモード
400	残高に十分な費用がありません

レポートの作成

このメソッドは、新しい被リンクレポートを作成する事ができます。

リクエストフォーマット

Title of the code block

コピー

POST /backlink-reports

{

   "mode":"domain",

   "target":"http://host/url"

}

リクエストパラメータ

名称	必須	説明
mode	Yes	domain \| host \| url
target	Yes	ドメインまたは正確なURL

結果

成功すると、サーバーは作成されたレポート ID を返します。

レスポンス例

Title of the code block

コピー

{

   "report_id":1

}

レスポンスパラメータ

名称	説明
report_id	レポート ID

エラー

HTTP コード	エラーメッセージ
400	無効なURL
400	無効なドメイン
400	無効なモード
400	被リンクの取得に失敗しました。後ほどお試しください
400	残高に十分な費用がありません

レポートの削除

このメソッドは、被リンクレポートを削除する事ができます。

リクエストフォーマット

Title of the code block

コピー

DELETE /backlink-reports/{report_id}

リクエストパラメータ

名称	必須	説明
report_id	Yes	レポート ID

結果

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

エラー

HTTP コード	エラーメッセージ
404	被リンクレポートは見つかりませんでした

レポートの更新

このメソッドは被リンクレポートを更新する事ができます。

リクエストフォーマット

Title of the code block

コピー

PUT /backlink-reports

{

   "report_id":1

}

リクエストパラメータ

名称	必須	説明
report_id	Yes	レポート ID

結果

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

エラー

HTTP コード	エラーメッセージ
400	無効なレポート ID
404	被リンクレポートが見つかりませんでした
400	被リンクの取得に失敗しました。後ほどお試しください
400	残高に十分な費用がありません

レポート概要

このメソッドは、レポートの全ての被リンクに関する詳しい情報を取得する事ができます。

リクエストフォーマット

Title of the code block

コピー

GET /backlink-reports/{report_id}/overview

リクエストパラメータ

名称	必須	説明
report_id	Yes	レポート ID

結果

成功すると、サーバーはレポートの全ての被リンクに関する詳しい情報を返します。

レスポンス例

Title of the code block

コピー

{

   "report_id":5,

   "created":"2021-10-06",

   "target":"seranking.com",

   "mode":"domain",

   "inlink_rank":58,

   "domain_inlink_rank":82,

   "backlinks":{

      "total":425573,

      "nofollow_backlinks":18667,

      "edu_backlinks":11,

      "gov_backlinks":4,

      "backlinks_to_homepage":5915,

      "backlinks_saved":15284,

      "per_domain":0

   },

   "domains":{

      "total":5682,

      "domains_to_homepage":2665,

      "domains_to_otherpage":2846,

      "domains_saved":5492,

      "top_domains":[

         {

            "domain":"nl",

            "count":"3410",

            "name":"Netherlands",

            "country":"NL"

         },

         {

            "domain":"it",

            "count":"161",

            "name":"Italy",

            "country":"IT"

         },

         {

            "domain":"uk",

            "count":"160",

            "name":"United Kingdom",

            "country":"GB"

         },

         {

            "domain":"jp",

            "count":"136",

            "name":"Japan",

            "country":"JP"

         },

         {

            "domain":"ru",

            "count":"128",

            "name":"Russia",

            "country":"RU"

         },

         {

            "domain":"pw",

            "count":"121",

            "name":"Palau",

            "country":"PW"

         }

      ]

   },

   "anchors":{

      "total":1817,

      "top_anchors":{

         "links":[

            {

               "anchor":"",

               "count":"9613"

            },

            {

               "anchor":"SE Ranking",

               "count":"1224"

            },

            {

               "anchor":"seranking.com",

               "count":"363"

            },

            {

               "anchor":"SERanking",

               "count":"272"

            },

            {

               "anchor":"SEO Software for 360 SEO Analysis of your Website.",

               "count":"138"

            },

            {

               "anchor":"SERanking SEO monitaring",

               "count":"117"

            },

            {

               "anchor":"https://seranking.com/",

               "count":"110"

            },

            {

               "anchor":"Seranking LTD",

               "count":"77"

            },

            {

               "anchor":"無料で試してみる",

               "count":"71"

            },

            {

               "anchor":"301",

               "count":"67"

            }

         ],

         "domains":[

            {

               "anchor":"SE Ranking",

               "count":"1136"

            },

            {

               "anchor":"",

               "count":"424"

            },

            {

               "anchor":"seranking.com",

               "count":"360"

            },

            {

               "anchor":"SERanking",

               "count":"272"

            },

            {

               "anchor":"SEO Software for 360 SEO Analysis of your Website.",

               "count":"134"

            },

            {

               "anchor":"https://seranking.com/",

               "count":"99"

            },

            {

               "anchor":"Seranking LTD",

               "count":"77"

            },

            {

               "anchor":"301",

               "count":"67"

            },

            {

               "anchor":".",

               "count":"42"

            },

            {

               "anchor":"Backlink Checker: Spy on Competitor Backlinks.",

               "count":"38"

            }

         ]

      }

   },

   "ips":null,

   "subnets":null

}

エラー

HTTP コード	エラーメッセージ
400	無効なレポートID
404	被リンクレポートが見つかりませんでした

レポートに関する被リンクリスト

このメソッドは、レポートに関するウェブサイトの被リンク数とリストを取得する事ができます。

リクエストフォーマット

Title of the code block

コピー

GET /backlink-reports/{report_id}/backlinks?limit=100&offset=0

リクエストパラメータ

名称	必須	説明
report_id	Yes	レポート ID
limit	No	被リンク数
offset	No	オフセット値

結果

成功すると、サーバーはレポートに関するウェブサイトの被リンク数とリストを返します。

レスポンス例

Title of the code block

コピー

{

   "total_backlinks":15284,

   "backlinks":[

      {

         "id":40624,

       "url":"http://operomagna.it/web-seo-consultant/website-seo-checker.htm",

         "title":"checker > web seo consultant > website seo checker",

         "anchor_id":786,

         "domain_id":639,

         "image":1,

         "nofollow":1,

         "inlink_rank":1,

         "first_seen":"2021-05-24",

         "last_visited":"2021-05-24",

         "page_id":605,

         "ugc":0,

         "sponsored":0,

         "lost_date":null,

         "anchor":"On-Page SEO Checker SE Ranking.",

         "url_to":"https://help.seranking.com/tools/on-page-seo-checker/",

         "domain_inlink_rank":11

      },

      {

         "id":40626,

         "url":"https://webbaohiem.net/bo-him-dao-cong-c-bo-v-doanh-nhan.html",

         "title":"Bảo hiểm D&O: Công cụ bảo vệ doanh nhân - Web Bảo Hiểm",

         "anchor_id":788,

         "domain_id":641,

         "image":1,

         "nofollow":1,

         "inlink_rank":3,

         "first_seen":"2021-05-24",

         "last_visited":"2021-05-24",

         "page_id":607,

         "ugc":0,

         "sponsored":0,

         "lost_date":null,

         "anchor":"link",

"url_to":"https://online.seranking.com/research.overview.html?filter=base_domain&input=gayincesttube.com",

         "domain_inlink_rank":37

      }

   ]

}

エラー

HTTP コード	エラーメッセージ
400	無効なレポートID
404	被リンクレポートが見つかりませんでした

レポートに関するドメインリスト

このメソッドは、被リンクレポートに関するドメイン数とリストを取得する事ができます。

リクエストフォーマット

Title of the code block

コピー

GET /backlink-reports/{report_id}/domains?limit=100&offset=0

リクエストパラメータ

名称	必須	説明
report_id	Yes	レポート ID
limit	No	ドメイン数
offset	No	オフセット値

結果

成功すると、サーバーは被リンクレポートに関するドメイン数とリストを返します。

レスポンス例

Title of the code block

コピー

{

   "total_domains":5491,

   "domains":[

      {

         "id":"2",

         "yandex_x":null,

         "domain_inlink_rank":"64",

         "backlinks":"13",

         "first_seen":"2021-05-23",

         "lost_date":null,

         "domain":"seranking.ru"

      },

      {

         "id":"21",

         "yandex_x":null,

         "domain_inlink_rank":"9",

         "backlinks":"1",

         "first_seen":"2021-03-16",

         "lost_date":null,

         "domain":"www.ruecouponcode.com"

      },

      {

         "id":"22",

         "yandex_x":null,

         "domain_inlink_rank":"60",

         "backlinks":"1",

         "first_seen":"2021-04-05",

         "lost_date":null,

         "domain":"p.eurekster.com"

      }

   ]

}

エラー

HTTP コード	エラーメッセージ
400	無効なレポートID
404	被リンクレポートが見つかりませんでした

レポートに関するアンカーのリスト

このメソッドは、被リンクレポートに関するアンカー数とリストを取得する事ができます。

リクエストフォーマット

Title of the code block

コピー

GET /backlink-reports/{report_id}/anchors?limit=100&offset=0

リクエストパラメータ

名称	必須	説明
report_id	Yes	レポート ID
limit	No	アンカー数
offset	No	オフセット値

結果

成功すると、サーバーは被リンクレポートに関するアンカー数とリストを返します。

レスポンス例

Title of the code block

コピー

{

   "total_anchors":1808,

   "anchors":[

      {

         "id":"786",

         "anchor":"On-Page SEO Checker SE Ranking.",

         "domains":"3",

         "backlinks":"3",

         "first_seen":"2021-05-11",

         "last_visited":"2021-05-24",

         "dofollow":"0",

         "words":"5"

      },

      {

         "id":"787",

         "anchor":"feat",

         "domains":"1",

         "backlinks":"1",

         "first_seen":"2021-05-24",

         "last_visited":"2021-05-24",

         "dofollow":"0",

         "words":"1"

      },

      {

         "id":"788",

         "anchor":"link",

         "domains":"20",

         "backlinks":"20",

         "first_seen":"2019-02-25",

         "last_visited":"2021-05-24",

         "dofollow":"3",

         "words":"1"

      }

   ]

}

エラー

HTTP コード	エラーメッセージ
400	無効なレポートID
404	被リンクレポートが見つかりませんでした

被リンクチェッカー (ツール)

レポートのリスト

リクエスト フォーマット

リクエスト パラメータ

結果

レスポンス例

レスポンス パラメータ

新しいレポートデータ

リクエスト フォーマット

リクエスト パラメータ

結果

レスポンス例

レスポンス パラメータ

エラー

レポートの作成

リクエスト フォーマット

リクエスト パラメータ

結果

レスポンス例

レスポンス パラメータ

エラー

レポートの削除

リクエスト フォーマット

リクエスト パラメータ

結果

エラー

レポートの更新

リクエスト フォーマット

リクエスト パラメータ

結果

エラー

レポート概要

リクエスト フォーマット

リクエスト パラメータ

結果

レスポンス例

エラー

レポートに関する被リンクリスト

リクエスト フォーマット

リクエスト パラメータ

結果

レスポンス例

エラー

レポートに関するドメインリスト

リクエスト フォーマット

リクエスト パラメータ

結果

レスポンス例

エラー

レポートに関するアンカーのリスト

リクエスト フォーマット

リクエスト パラメータ

結果

レスポンス例

エラー

リクエストフォーマット

リクエストパラメータ

レスポンスパラメータ

リクエストフォーマット

リクエストパラメータ

レスポンスパラメータ

リクエストフォーマット

リクエストパラメータ

レスポンスパラメータ

リクエストフォーマット

リクエストパラメータ

リクエストフォーマット

リクエストパラメータ

リクエストフォーマット

リクエストパラメータ

リクエストフォーマット

リクエストパラメータ

リクエストフォーマット

リクエストパラメータ

リクエストフォーマット

リクエストパラメータ