seo/
backlinks-summary

ドメイン、サブドメイン、ページURLの被リンクプロファイルを1行に集約し、権威スコア、被リンク数と参照ドメイン数、nofollow とリンク切れの件数、スパムスコアを返します。

Backlinks Summary API

ドメインまたはページを指定
0〜1000の権威スコア
リンク元の内訳
1リクエストあたり10クレジット
準備完了
README

SocQ 編集 · 更新

Backlinks Summary

被リンクプロファイルとは、ほかのサイトからドメインやページに向けられたリンクの全体のことで、ここでは0〜1000の権威スコア、被リンク・参照ドメイン・IP・サブネットの総数、0〜100のスパムスコア、そしてリンク元サイトの国、トップレベルドメイン、サイトの種類、ページ内の位置ごとの内訳で測ります。これらの数値をあわせて読むとサイトのリンクの強さと多様さがわかり、リンク監査、サイト間の権威性の比較、提携先の事前調査で最初に必要になる情報がそろいます。

Backlinks Summary API の主な機能

  • ドメイン、サブドメイン、単一ページに対応target にはドメイン単体、サブドメイン、ページの完全なURLを指定できます。ドメインの集計にはすべてのサブドメインが含まれ、ページURLならそのページへのリンクを測ります。
  • 権威性とスパムのシグナルを同時にrank は被リンクプロファイルを0〜1000で、spam_score は0〜100で評価し、first_seen_at は対象への被リンクが最初に見つかった日を示します。
  • リンク単位からルートドメイン単位までの件数backlinks_count、referring_pages_count、referring_domains_count、referring_main_domains_count が各レベルのリンク数を数え、referring_ips_count と referring_subnets_count がリンク元のホストの分散を示します。
  • nofollow とリンク切れの総数2つの nofollow の件数が評価を渡さないリンク元ドメインとページを示し、broken_backlinks_count と broken_pages_count は表示できなくなった対象ページに届くリンクを、crawled_pages_count とあわせて測ります。
  • 6種類の順位付き内訳referring_tlds、referring_countries、link_types、link_attributes、platform_types、semantic_locations は、それぞれ名前と件数の組を多い順に並べます。

Backlinks Summary API のパラメータ

パラメータ必須説明
target必須集計するドメイン、サブドメイン、またはページの完全なURLです(例:notion.so、https://example.com/blog/)。ドメインにはそのサブドメインも含まれます。

Backlinks Summary API の使い方

対象を1つ送信し、タスクが完了したら1行のサマリーを読み取ります。

  1. {"target": "notion.so"} を /v1/seo/backlinks-summary に POST し、レスポンスの task_id を控えます。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からサマリーを読み取ります。タスクの結果は1行で、results.next_cursor は has_more が true のときだけ使います。
curl -X POST "https://api.socq.ai/v1/seo/backlinks-summary" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so"}'

# Then poll GET /v1/tasks/{task_id}; one summary costs 10 credits.

Backlinks Summary API の主なユースケース

  • 候補サイト間の権威性比較: 各サイトを順に送信して rank、referring_domains_count、spam_score を並べ、競合、提携先、買収候補のうちどれが強い被リンクプロファイルを持つかを確かめます。
  • リンク掲載前のサイト審査: 候補サイトの spam_score を確認し、referring_ips_count と referring_subnets_count を referring_domains_count と比べて、リンクが多数の独立したホストから来ているかを確かめます。
  • リンク回復作業の規模の見積もり: broken_backlinks_count と broken_pages_count から、獲得したリンクのうちどれだけが存在しないページに届いているかがわかり、リダイレクトやコンテンツ復旧で解消すべき作業量になります。
  • リンク元の分布のレポート: referring_countries、referring_tlds、platform_types を使い、市場参入やPR露出のレポートでリンク元サイトの地域と種類を説明します。
  • スナップショット間の被リンク推移の追跡: rank、backlinks_count、referring_domains_count を collected_at とともに定期的に保存し、プロファイルの増減をグラフにします。

Backlinks Summary API 活用のヒント

  • ルートドメインの集計には blog. や shop. などすべてのサブドメインが含まれるため、1つのサブドメインだけを測りたい場合はそれを target に指定してください。
  • referring_countries と semantic_locations で name が空のグループは出どころや位置が不明なものとして扱い、国別やページ内の位置別の割合を計算するときは除外してください。
  • 内訳の件数はすべてドメイン数ではなく被リンク数なので、割合は referring_domains_count ではなく backlinks_count を分母にして計算してください。

Backlinks Summary API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Backlinks API — ドメインやページへの個々のリンクを強い順に最大1,000件、リンク元ページ、アンカーテキスト、dofollow の有無、権威スコア、初回・最終検出日とともに一覧にします。
  • Referring Domains API — サイトやページにリンクしているドメインを1つずつ1行で、権威スコア、被リンク数とページ数、スパムスコア、リンクの開始日と終了日とともに一覧にします。
  • Backlink Competitors API — サイトやページともっとも多くの参照ドメインを共有するドメインを、重なりの順に権威スコア付きで見つけます。

他のプラットフォームを見る

SEOのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Backlinks Summary API — よくある質問

Backlinks Summary APIは、1つのドメイン、サブドメイン、ページURLについて被リンクプロファイル全体を測定するためのプログラムインターフェースです。権威スコア、リンクと参照ドメインの総数、nofollow とリンク切れの件数、スパムスコア、リンク元サイトの内訳を1行で返します。

使えます。rank は対象の被リンクプロファイルから算出される0〜1000の権威スコアで、値が高いほどプロファイルが強いことを示します。0〜100の spam_score とあわせて読んでください。

リンク単位の行が必要なら同じ target を Backlinks API に、リンク元ドメインごとの行が必要なら Referring Domains API に送ってください。サマリー自体には件数と内訳が入ります。

対象の被リンクプロファイルの大きさにかかわらず、1リクエストにつき固定10クレジットで、1行が返ります。