Referring Domains
参照ドメインとは、ドメインやページにリンクしている個々のウェブサイトのことで、それぞれ1回だけ数えられ、権威スコア、提供しているリンク数とリンク元ページ数、そのうち nofollow のページやリンク切れのページを指すものの数、スパムスコア、リンクを始めた日と外した日を持っています。生のリンク数ではなくサイト数で数えるとリンクの人気をもっとも公平に測れるため、これらの行はアウトリーチ先リスト、リンクギャップの比較、獲得・喪失したリンク元サイトのレポートの基礎になります。
Referring Domains API の主な機能
- リンク元ドメインごとに1行各行は対象のドメイン、サブドメイン、ページにリンクしているサイトなので、300本のリンクを張っているブログも1回だけ現れます。results_limit で1〜1,000件を取得できます。
- 各ドメインのリンクの深さbacklinks_count と referring_pages_count はドメインが提供するリンク数とページ数を、nofollow_referring_pages_count と broken_backlinks_count はそのうち nofollow のものとリンク切れのページに届くものの数を示します。
- サイトごとの品質シグナルrank はリンク元ドメインの権威性を0〜1000で、spam_score は0〜100で評価するため、長いリストも読む前に並べ替えられます。
- リンク関係の開始と終了first_seen_at はそのドメインの最初のリンクが見つかった日、lost_at はリンクが外された日を記録し、リンクが生きている間は空のままです。
Referring Domains API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
target | 必須 | リンク元ドメインを調べるドメイン、サブドメイン、またはページの完全なURLです(例:notion.so、https://example.com/pricing)。 |
results_limit | 任意 | 返す参照ドメインの数で、1〜1000の整数です。デフォルトは100です。 |
Referring Domains API の使い方
対象を results_limit とともに送信し、リンク元ドメインをページごとに集めます。
- {"target": "notion.so", "results_limit": 100} を /v1/seo/referring-domains に POST し、task_id を保存します。
- GET /v1/tasks/{task_id} をポーリングします。status が succeeded になればドメインの準備は完了です。
- results.items から各ドメインを読み取り、has_more が true の間は results.next_cursor で次のページをリクエストします。
curl -X POST "https://api.socq.ai/v1/seo/referring-domains" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","results_limit":100}'
# Poll GET /v1/tasks/{task_id} for the linking domains.Referring Domains API の主なユースケース
- 競合からのアウトリーチ先リスト作成: 競合のドメインを実行し、rank が高く spam_score が低い行を残して、各ドメインの背後にあるサイトに連絡します。
- 2サイト間のリンクギャップ確認: 自社サイトと競合の参照ドメインを取得してドメインの列を比べ、競合にだけリンクしているサイトを見つけます。
- 失ったリンク元サイトのレポート: lost_at が入っている行を絞り込んで rank 順に並べ、価値の高いどのサイトがいつリンクを外したかを確かめます。
- 多数のページから張られたリンクの確認: referring_pages_count で並べ替え、フッター、サイドバー、ブログロールなど、数百のページからリンクしている見直し対象のドメインを見つけます。
Referring Domains API 活用のヒント
- nofollow_referring_pages_count が referring_pages_count と等しければ、そのドメインのリンク元ページはすべて nofollow です。このチェックで評価を渡すドメインとそうでないドメインを分けてください。
- broken_backlinks_count が0より大きいドメインがあれば、同じ target で Backlinks API を実行してエラーになる target_url を特定し、リダイレクトしてください。
- 1回のリクエストで返るドメインは最大1,000件で、それより大きいプロファイルは一部しかカバーされないため、大量に取得する前に Backlinks Summary API で referring_domains_count を確認してください。
関連API
Referring Domains API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。
- Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
- Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
- Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
- Backlinks Summary API — 1つのドメイン、サブドメイン、ページの被リンクプロファイルを、権威スコア、被リンク数と参照ドメイン数、スパムスコア、リンク元の内訳とともに1行にまとめます。
- Backlinks API — ドメインやページへの個々のリンクを強い順に最大1,000件、リンク元ページ、アンカーテキスト、dofollow の有無、権威スコア、初回・最終検出日とともに一覧にします。
- Backlink Competitors API — サイトやページともっとも多くの参照ドメインを共有するドメインを、重なりの順に権威スコア付きで見つけます。
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API