Backlinks
被リンクとは、ほかのサイトのページからドメインやページに向けられた1本のリンクで、リンク元ページとそのタイトル、リンク先URL、アンカーテキスト、dofollow の有無と rel 属性、リンク・ページ・ドメインそれぞれの権威スコア、スパムスコア、ページ内の位置、初めて検出された日と最後に検出された日によって表されます。1本ずつ並べると、どのページとアンカーがサイトの権威性を支えているかがわかり、アンカーテキストの監査、競合のリンク調査、アウトリーチ先リストの作成、新規・消失・リンク切れの監視に活用できます。
Backlinks API の主な機能
- すべてのリンクを強い順にドメイン、サブドメイン、ページURLを指定すると個々の被リンクが強いものから順に返り、results_limit で1リクエストあたり1〜1,000件を指定できます。
- リンクの両端の情報source_url、source_domain、source_title でリンク元ページを特定し、language はその言語コード、target_url は対象のどのページがリンクを受けているかを示します。
- アンカー、マークアップ、掲載位置anchor はリンクテキスト、link_type はアンカー・画像・リダイレクト・canonical リンクの区別、is_dofollow と attributes は rel の値、semantic_location は記事本文・ナビゲーション・フッターといった掲載位置を示します。
- 3つのレベルの権威スコアrank はリンク自体、source_page_rank と source_domain_rank はリンクが置かれたページとサイトを、いずれも0〜1000で評価し、0〜100の spam_score も並びます。
- リンクのライフサイクルを示すフラグと日付is_new は前回のクロール以降に見つかったリンク、is_lost はページから削除されたリンク、is_broken は表示できなくなったページを指すリンクを示し、first_seen_at と last_seen_at が期間を示します。
Backlinks API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
target | 必須 | 被リンクを調べるドメイン、サブドメイン、またはページの完全なURLです(例:notion.so、https://example.com/blog/post)。 |
results_limit | 任意 | 返す被リンクの数で、1〜1000の整数です。デフォルトは100で、強いリンクから順に返ります。 |
Backlinks API の使い方
対象と必要なリンク数を送信し、リンクの行をページ送りで読み取ります。
- {"target": "notion.so", "results_limit": 100} を /v1/seo/backlinks に POST します。
- 返された task_id で、status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からリンクを読み取り、すべてのリンクを読み込むまで、has_more が true の間は results.next_cursor でリクエストを続けます。
curl -X POST "https://api.socq.ai/v1/seo/backlinks" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","results_limit":100}'
# 10 credits per request plus 0.02 per backlink returned.Backlinks API の主なユースケース
- アンカーテキストの監査: 行を anchor でグループ化し、ブランド名、URLそのもの、キーワードを含むフレーズがプロファイルに占める割合を確かめ、キーワードの多いリンクの is_dofollow を確認します。
- 競合の強いリンクの洗い出し: 競合のドメインを実行し、rank の上位の行を source_domain と source_title とともに取り出して、アプローチする価値のある媒体の候補リストにします。
- リンクを集めているページの把握: 自社ドメインの target_url ごとに行数を数え、どの記事、ツール、ランディングページが被リンクを獲得していて、更新や内部リンクを強化すべきかを把握します。
- 新規・消失リンクの監視: is_new と is_lost を last_seen_at とともに絞り込み、サイトが獲得したリンクと失ったリンクを報告し、削除された掲載をフォローアップします。
- リンク切れのリンク先のリダイレクト: is_broken が付いた行には現在エラーになる target_url が並ぶため、存在しないページごとにリダイレクトを設定し、届いていたリンクを取り戻せます。
Backlinks API 活用のヒント
- id はリンク元ページ、リンク先ページ、アンカーから作られ、同じリンクなら変わらないため、実行をまたいでリンクを保存するときのキーに使ってください。
- リンクは1本ずつ別の行になるため、同じ source_domain から複数の行が返ります。サイトごとに1行が必要な場合は source_domain でグループ化するか、Referring Domains API に切り替えてください。
- ページから消えたリンクも is_lost が付いた状態で一覧に残ることがあるため、生きているリンクを数える前に is_lost が true の行を除外してください。
- 一覧は強いリンクから始まるので、results_limit は実際に確認する深さにとどめてください。上限を小さくすれば、もっとも弱いリンクとリンクごとの料金を削れます。
関連API
Backlinks API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。
- Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
- Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
- Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
- Backlinks Summary API — 1つのドメイン、サブドメイン、ページの被リンクプロファイルを、権威スコア、被リンク数と参照ドメイン数、スパムスコア、リンク元の内訳とともに1行にまとめます。
- Referring Domains API — サイトやページにリンクしているドメインを1つずつ1行で、権威スコア、被リンク数とページ数、スパムスコア、リンクの開始日と終了日とともに一覧にします。
- 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