リンク切れの被リンク

API + MCP

GET/v3/site-explorer/broken-backlinks

クエリパラメータ

timeoutinteger

手動で設定するタイムアウト時間（秒）です。

limitinteger

返す結果数です。

デフォルト:1000

order_bystring

結果の並び替えに使用する列。利用可能な列識別子はレスポンススキーマを参照してください。ただし、このエンドポイントの order_by では http_code_target、last_visited_target、link_group_count はサポートされません。

Example:field_a,field_b:asc,field_c:desc

wherestring

フィルター式。次の列識別子が認識されます（select パラメータで認識される識別子とは異なります）。

ahrefs_rank_source: 当社データベース内の他サイトと比較した参照元ドメインの被リンクプロファイルの強さ（#1 が最も強い）。
type: integer

ahrefs_rank_target: 当社データベース内の他サイトと比較したターゲットドメインの被リンクプロファイルの強さ（#1 が最も強い）。
type: integer

alt: リンクの alt 属性。
type: string nullable

anchor: URL を指すリンク内のクリック可能なテキスト。
type: string

class_c (5 units): 参照元ページへリンクしている固有の class_c サブネット数。
type: integer

domain_rating_source: 当社データベース内の他サイトと比較した参照元ドメインの被リンクプロファイルの強さ（100 点スケール）。
type: float

domain_rating_target: 当社データベース内の他サイトと比較したターゲットドメインの被リンクプロファイルの強さ（100 点スケール）。
type: float

encoding: 参照元ページ HTML の文字エンコーディング。
type: string

first_seen: 参照元ページ URL を初めて発見した日付。
type: datetime

first_seen_link: 特定の参照元ページで、ターゲットへの被リンクを初めて見つけた日付。
type: datetime

http_code: 参照元ページのクロール時に返された HTTP プロトコルの返却コード。
type: integer

http_code_target: ターゲットページのクロール時に返された HTTP プロトコルの返却コード。
type: integer nullable

http_crawl: JavaScript の実行やページのレンダリングを行わずにリンクが検出されました。
type: boolean

ip_source: 参照元ドメインの IP アドレス。
type: string nullable

is_alternate: rel="alternate" 属性のリンク。
type: boolean

is_canonical: rel="canonical" 属性のリンク。
type: boolean

is_content: ページ内で最も大きいコンテンツ部分から見つかったリンク。
type: boolean

is_dofollow: 特別な nofollow 属性が付いていないリンク。
type: boolean

is_form: form HTML タグ内で見つかったリンク。
type: boolean

is_frame: iframe HTML タグ内で見つかったリンク。
type: boolean

is_homepage_link: 参照元サイトのホームページ上で見つかったリンク。
type: boolean

is_image: href 属性内に画像が含まれる通常のリンク。
type: boolean

is_nofollow: リンクまたは参照元ページに nofollow 属性が設定されています。
type: boolean

is_non_html: 非 HTML コンテンツの URL を指すリンク。
type: boolean

is_redirect: リダイレクト経由でターゲットを指しているリンク。
type: boolean

is_root_source: 参照元ドメイン名がルートドメイン名です。
type: boolean

is_root_target: ターゲットドメイン名がルートドメイン名です。
type: boolean

is_rss: RSS フィード内で見つかったリンク。
type: boolean

is_spam: 被リンクが既知のスパム性の高いドメインからのものかどうかを示します。
type: boolean

is_sponsored: 参照元ページ HTML に Sponsored 属性が設定されているリンク。
type: boolean

is_text: スタンダードな href ハイパーリンク。
type: boolean

is_ugc: 参照元ページ HTML に User Generated Content 属性が設定されているリンク。
type: boolean

js_crawl: JavaScript を実行してページをレンダリングした後にリンクが検出されました。
type: boolean

languages: 参照元ページのメタデータに記載されている、またはクローラーが HTML 内にあると検出した言語。
type: array(string)

last_seen: リンクが失われたことを確認した日付。
type: datetime nullable

last_visited: 被リンクが有効か確認するために参照元ページを最後に再クロールした日付。
type: datetime

last_visited_target: ターゲットページが破損しているか確認するために最後に再クロールした日付。
type: datetime nullable

len_url_redirect: リダイレクトチェーンの URL 数。
type: integer

link_group_count: aggregation パラメータに基づいてグルーピングされた被リンク数。aggregation が 'all' の場合、このフィールドは使用できません。
type: integer

link_type: 被リンクの種類。
type: string
enum: "redirect" "frame" "text" "form" "canonical" "alternate" "rss" "image"

linked_domains_source_domain: 参照元ドメインからリンクされている固有のルートドメイン数。
type: integer

linked_domains_source_page: 参照元ページからリンクされている固有のルートドメイン数。
type: integer

linked_domains_target_domain: ターゲットドメインからリンクされている固有のルートドメイン数。
type: integer

links_external: 参照元ページからの外部リンク数。
type: integer

links_internal: 参照元ページからの内部リンク数。
type: integer

name_source: サブドメインを含む参照元ドメイン名の完全な名前。
type: string

name_target: サブドメインを含むターゲットドメイン名の完全な名前。
type: string

page_category_source: 参照元ページの AI 予測による階層カテゴリパスのカンマ区切りリスト。各値はスラッシュ始まりのパスです（例: /Business_and_Industrial/Advertising_and_Marketing/Marketing）。
type: string nullable

page_size: 参照元ページのコンテンツサイズ（バイト）。
type: integer

page_type_source: 参照元ページの AI 予測による階層ページタイプパスのカンマ区切りリスト。各値はスラッシュ始まりのパスです（例: /Article/How_to）。
type: string nullable

port_source: 参照元ページ URL のネットワークポート。
type: integer

port_target: ターゲットページ URL のネットワークポート。
type: integer

positions: 参照元ページが上位 100 位以内でランクインしているキーワード数。
type: integer

positions_source_domain: 参照元ドメインが上位 100 位以内でランクインしているキーワード数。
type: integer

powered_by: 参照元ページのコンテンツの構築・配信に使用されている Web 技術。
type: array(string)

redirect_code: リダイレクト経由でターゲットを指している参照元ページの HTTP ステータスコード。
type: integer nullable

redirect_kind: ターゲットのリダイレクト URL またはリダイレクトチェーンが返す HTTP ステータスコード。
type: array(integer)

refdomains_source (5 units): 参照元ページにリンクしている固有の参照ドメイン数。
type: integer

refdomains_source_domain (5 units): 参照元ドメインにリンクしている固有の参照ドメイン数。
type: integer

refdomains_target_domain (5 units): ターゲットドメインにリンクしている固有の参照ドメイン数。
type: integer

root_name_source: サブドメインを含まない参照元ドメインのルートドメイン名。
type: string

root_name_target: サブドメインを含まないターゲットドメインのルートドメイン名。
type: string

snippet_left: リンク直前に表示されるテキストのスニペット。
type: string

snippet_right: リンク直後に表示されるテキストのスニペット。
type: string

source_page_author: 参照元ページの著者。
type: string nullable

title: 参照元ページの html title。
type: string

tld_class_source: 参照元ドメインのトップレベルドメインのクラス。
type: string
enum: "gov" "edu" "normal"

tld_class_target: ターゲットドメインのトップレベルドメインのクラス。
type: string
enum: "gov" "edu" "normal"

traffic (10 units): 検索からの参照元ページの推定月間オーガニックトラフィック。
type: integer

traffic_domain (10 units): 検索からの参照元ドメインの推定月間オーガニックトラフィック。
type: integer

url_from: ターゲットへのリンクを含むページの URL。
type: string

url_from_plain: フィルター用途に最適化した参照元ページ URL。
type: string

url_rating_source: 当社データベース内の他サイトと比較した参照元ページの被リンクプロファイルの強さ（100 点スケール）。
type: float

url_redirect: リンクのターゲット URL が指すリダイレクトチェーン。
type: array(url)

url_redirect_with_target: リダイレクトチェーンを含むリンクのターゲット URL。
type: array(string)

url_to: 被リンクが指す URL。
type: string

url_to_plain: フィルター用途に最適化したターゲットページ URL。
type: string

selectstring必須

返すカラムのカンマ区切りリストです。有効なカラム識別子はレスポンスのスキーマを参照してください。

protocolstring

ターゲットのプロトコル。

許可される値:bothhttphttps

デフォルト:both

targetstring必須

検索対象：ドメインまたはURL。

modestring

入力したターゲットに基づく検索範囲。

許可される値:exactprefixdomainsubdomains

デフォルト:subdomains

aggregationstring

被リンクのグルーピングモード。

許可される値:similar_links1_per_domainall

デフォルト:similar_links

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

backlinksarray<object>

ahrefs_rank_sourceinteger

データベースに登録されている他のウェブサイトと比較した参照ドメインの被リンクプロファイルの強さで、ランク1位が最も強いことを意味します。

ahrefs_rank_targetinteger

データベースに登録されている他のウェブサイトと比較したターゲットドメインの被リンクプロファイルの強さで、ランク1位が最も強いことを意味します。

altstring or null

リンクの alt 属性です。

anchorstring

リンクの中で、URL を指すクリック可能な単語。

class_cinteger

(5 units) 参照ページにリンクしている、ユニークな class_c サブネットの数です。

domain_rating_sourcenumber

参照ドメインの被リンクプロフィールの強さを、当社データベース内の他と比較して 100 ポイントスケールで示します。

domain_rating_targetnumber

参照ドメインの被リンクプロフィールの強さを、当社データベース内の他と比較して 100 ポイントスケールで示します。

encodingstring

参照ページ HTML の文字エンコーディングです。

first_seenstring

参照ページの URL が初めて検出された日付です。

first_seen_linkstring

特定の参照ページで、ターゲットへの被リンクを最初に発見した日です。

http_codeinteger

参照ページのクロール時に HTTP プロトコルから返されたリターンコードです。

http_code_targetinteger or null

ターゲットページのクロール時に返された HTTP ステータスコード。

http_crawlboolean

JavaScript を実行せず、ページをレンダリングしない状態でリンクが検出されました。

ip_sourcestring or null

参照ドメインのIPアドレス。

is_alternateboolean

rel="alternate" 属性を持つリンク。

is_canonicalboolean

rel="canonical" 属性を持つリンク。

is_contentboolean

ページ内で最も大きいコンテンツ部分で見つかったリンク。

is_dofollowboolean

特別なNofollow属性が付いていないリンク。

is_formboolean

form HTMLタグ内で見つかったリンク。

is_frameboolean

iframe HTMLタグ内で見つかったリンク。

is_imageboolean

href属性内に画像が含まれている通常のリンク。

is_nofollowboolean

リンクまたは参照ページにNofollow属性が設定されています。

is_redirectboolean

リダイレクト経由でターゲットを指しているリンク。

is_root_sourceboolean

参照ドメイン名はルートドメイン名です。

is_root_targetboolean

ターゲットのドメイン名はルートドメイン名です。

is_rssboolean

リンクはRSSフィード内で見つかりました。

is_spamboolean

被リンクが既知のスパム性の高いドメインからのものかどうかを示します。

is_sponsoredboolean

参照元ページのHTMLで、リンクにSponsored属性が設定されています。

is_textboolean

リンクは標準的なhrefハイパーリンクです。

is_ugcboolean

参照元ページのHTMLで、リンクにUser Generated Content属性が設定されています。

js_crawlboolean

JavaScriptを実行してページをレンダリングした後に、リンクが発見されました。

languagesarray<string>

参照元ページのメタデータに記載されている言語、またはクローラーがHTML内にあると検出した言語です。

last_seenstring or null

リンクが失われたことを確認した日付です。

last_visitedstring

被リンクが生きていることを確認するために、参照ページを最後に再クロールを行った日付。

last_visited_targetstring or null

ターゲットページがリンク切れであることを確認するために、最後に再クロールを行った日です。

link_group_countinteger

集計パラメータに基づいてグループ化された被リンクの数です。このフィールドは、集計が'all'の場合は使用できません。

link_typestring

被リンクの種類です。

Allowed values:redirectframetextformcanonicalalternaterssimage

linked_domains_source_domaininteger

参照ドメインからリンクされたユニークなルートドメインの数です。

linked_domains_source_pageinteger

参照ページからリンクされたユニークなルートドメインの数です。

linked_domains_target_domaininteger

ターゲットドメインからリンクされたユニークなルートドメインの数です。

links_externalinteger

参照ページからの外部リンク数。

links_internalinteger

参照ページからの内部リンク数。

name_sourcestring

サブドメインを含む、完全な参照ドメイン名です。

name_targetstring

サブドメインを含む、完全なターゲットドメイン名です。

page_category_sourcestring or null

参照ページに対してAIが予測した階層カテゴリパスのカンマ区切りリストです。各値はスラッシュで始まるパスです（例: /Business_and_Industrial/Advertising_and_Marketing/Marketing）。

page_sizeinteger

参照ページコンテンツのサイズ（バイト単位）です。

page_type_sourcestring or null

参照ページに対してAIが予測した階層ページタイプパスのカンマ区切りリストです。各値はスラッシュで始まるパスです（例: /Article/How_to）。

port_sourceinteger

参照ページURLのネットワークポートです。

port_targetinteger

ターゲットページURLのネットワークポートです。

positionsinteger

参照ページが、上位 100 件以内にランクインしているキーワードの数です。

powered_byarray<string>

参照ページのコンテンツの構築および配信に使用されているWeb技術。

redirect_codeinteger or null

リダイレクト経由でターゲットを指している参照ページのHTTPステータスコード。

redirect_kindarray<integer>

ターゲットへリダイレクトするURL、またはリダイレクトチェーンによって返されるHTTPステータスコード。

refdomains_sourceinteger

（5単位）参照ページにリンクしている、ユニークな参照ドメイン（ルートドメイン）の数。

refdomains_source_domaininteger

（5単位）参照ドメインにリンクしている、ユニークな参照ドメイン（ルートドメイン）の数。

refdomains_target_domaininteger

（5単位）ターゲットドメインにリンクしている、ユニークな参照ドメイン（ルートドメイン）の数。

root_name_sourcestring

サブドメインを除いた、参照ドメインのルートドメイン名。

root_name_targetstring

サブドメインを除いた、ターゲットドメインのルートドメイン名。

snippet_leftstring

リンクの直前に表示されるテキストのスニペット。

snippet_rightstring

リンクの直後に表示されるテキストのスニペット。

source_page_authorstring or null

参照ページの著者。

titlestring

参照ページのHTMLタイトル。

tld_class_sourcestring

参照ドメインのトップレベルドメイン（TLD）クラス。

Allowed values:govedunormal

tld_class_targetstring

ターゲットドメインのトップレベルドメイン（TLD）クラス。

Allowed values:govedunormal

trafficinteger

（10 ユニット）参照ページの検索からの月間オーガニックトラフィックの推定値。

traffic_domaininteger

（10 ユニット）参照ドメインの検索からの月間オーガニックトラフィックの推定値。

url_fromstring

対象へのリンクを含むページの URL。

url_from_plainstring

フィルタとして使用できるように最適化された参照ページの URL。

url_rating_sourcenumber

参照ページの被リンクプロフィールの強さを、当社データベース内の他のページと比較して100点満点のスケールで表したものです。

url_redirectarray<string>

リンクのターゲット URL が指すリダイレクトチェーン。

url_redirect_with_targetarray<string>

リダイレクトチェーンを含むリンクのターゲット URL。

url_tostring

被リンクが指している URL。

url_to_plainstring

フィルタとして使用できるように最適化されたターゲットページの URL。