Docs
搜索文档...⌘K

失效的反向链接

API + MCP
GET/v3/site-explorer/broken-backlinks

查询参数

timeoutinteger

手动超时时长(秒)。

limitinteger

要返回的结果数量。

默认:1000
order_bystring

用于对结果排序的列。有效的列标识符请参见响应 Schema,但 http_code_targetlast_visited_targetlink_group_count 除外——此端点的 order_by 不支持它们。

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:该链接指向的 URL 为非 HTML 内容。
type: boolean

is_redirect:该链接通过重定向指向你的目标。
type: boolean

is_root_source:引用域名是根域名。
type: boolean

is_root_target:目标域名是根域名。
type: boolean

is_rss:该链接在 RSS feed 中被发现。
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:根据聚合参数被分组到一起的反向链接数量。该字段不能与聚合 '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必填

要返回的列的逗号分隔列表。有效的列标识符请参见响应 Schema。

protocolstring

目标的协议。

允许的值:bothhttphttps
默认:both
targetstring必填

搜索目标:域名或 URL。

modestring

基于你输入的目标所确定的搜索范围。

允许的值:exactprefixdomainsubdomains
默认:subdomains
aggregationstring

反向链接的分组模式。

允许的值:similar_links1_per_domainall
默认:similar_links
outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

backlinksarray<object>
ahrefs_rank_sourceinteger

引用域名的反向链接概况强度,通过与数据库中其他网站对比得出,排名第一代表最强。

ahrefs_rank_targetinteger

目标域名的反向链接概况强度,通过与数据库中其他网站对比得出,排名第一代表最强。

altstring or null

该链接的 alt 属性。

anchorstring

指向URL的链接中可点击的词。

class_cinteger

(5 个单位)链接到引用页面的唯一 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

引用域名的顶级域名类别。

Allowed values:govedunormal
tld_class_targetstring

目标域名的顶级域名类别。

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。