Docs
搜索文档...⌘K

反向链接

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

查询参数

timeoutinteger

手动超时时长(秒)。

limitinteger

要返回的结果数量。

默认:1000
order_bystring

用于对结果排序的列。有效的列标识符请参见响应 Schema,但 link_group_count 除外:此端点的 order_by 不支持该字段。

Example:field_a,field_b:asc,field_c:desc
wherestring

过滤表达式。可识别以下列标识符(这与 select 参数可识别的标识符不同)。

ahrefs_rank_source:引用域名的反向链接概况强度与我们数据库中其他网站相比的排名,#1 为最强。
类型:integer

ahrefs_rank_target:目标域名的反向链接概况强度与我们数据库中其他网站相比的排名,#1 为最强。
类型:integer

alt:链接的 alt 属性。
类型:string nullable

anchor:链接中可点击、指向某个 URL 的文字。
类型:string

broken_redirect_new_target:被修改的重定向的新目的地。
类型:string nullable

broken_redirect_reason:在上次抓取中,该重定向被判定为失效的原因。
类型:string nullable
枚举:"droppedmanual" "droppedtooold" "dropped" "codechanged" "nxdomain" "robotsdisallowed" "curlerror" "invalidtarget" "nomorecanonical" "isnowparked" "targetchanged"

broken_redirect_source:被修改的重定向 URL,导致该重定向失效。
类型:string nullable

class_c(5 单位):链接到引用页面的唯一 class_c 子网数量。
类型:integer

discovered_status:在上次抓取中发现该链接的原因:页面首次被抓取、页面新增了该链接,或该链接在被移除后再次出现。
类型:string nullable
枚举:"pagefound" "linkfound" "linkrestored"

domain_rating_source:引用域名的反向链接概况强度与我们数据库中其他网站相比的评分,按 0–100 计分。
类型:float

domain_rating_target:引用域名的反向链接概况强度与我们数据库中其他网站相比的评分,按 0–100 计分。
类型:float

drop_reason:我们将该链接从索引中移除的原因。
类型:string nullable
枚举:"manual" "noratingunused" "notop" "tooold" "oldunavailable" "rescursive" "duplicate" "nxdomain" "malformed" "blockedport" "disallowed" "unlinked"

encoding:引用页面 HTML 的字符集编码。
类型:string

first_seen:首次发现引用页面 URL 的日期。
类型:datetime

first_seen_link:我们首次在某个引用页面上发现指向你目标的反向链接的日期。
类型:datetime

http_code:抓取引用页面时返回的 HTTP 状态码。
类型:integer

http_crawl:未执行 javascript、也未渲染页面即发现该链接。
类型:boolean

ip_source:引用域名的 IP 地址。
类型:string nullable

is_alternate:带有 rel=“alternate” 属性的链接。
类型:boolean

is_canonical:带有 rel=“canonical” 属性的链接。
类型:boolean

is_content:该链接出现在页面最大块内容中。
类型:boolean

is_dofollow:该链接没有特殊的 nofollow 属性。
类型:boolean

is_form:该链接出现在 form HTML 标签中。
类型:boolean

is_frame:该链接出现在 iframe HTML 标签中。
类型:boolean

is_homepage_link:该链接出现在引用网站的首页上。
类型:boolean

is_image:该链接为常规链接,其 href 属性中包含图片。
类型:boolean

is_lost:该链接目前已不存在。
类型:boolean

is_new:该链接是在上次抓取中发现的。
类型:boolean

is_nofollow:该链接或引用页面设置了 Nofollow 属性。
类型:boolean

is_non_html:该链接指向的 URL 为非 HTML 内容。
类型:boolean

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

is_redirect_lost:该重定向链接目前已不存在。
类型:boolean

is_root_source:引用域名为根域名(root domain name)。
类型:boolean

is_root_target:目标域名为根域名(root domain name)。
类型:boolean

is_rss:该链接出现在 RSS feed 中。
类型:boolean

is_spam:指示该反向链接是否来自已知的垃圾域名。
类型:boolean

is_sponsored:引用页面 HTML 中为该链接设置了 Sponsored 属性。
类型:boolean

is_text:该链接为标准 href 超链接。
类型:boolean

is_ugc:引用页面 HTML 中为该链接设置了 User Generated Content 属性。
类型:boolean

js_crawl:在执行 javascript 并渲染页面后发现该链接。
类型:boolean

languages:引用页面元数据中列出的语言,或由爬虫检测到在 HTML 中出现的语言。
类型:array(string)

last_seen:我们发现该链接已丢失的日期。
类型:datetime nullable

last_visited:我们上次验证指向你目标页面的现存链接的日期。
类型:datetime

len_url_redirect:重定向链中的 URL 数量。
类型:integer

link_group_count:根据聚合参数分组后的反向链接数量。该字段不能与聚合 'all' 一起使用。
类型:integer

link_type:反向链接的类型。
类型:string
枚举:"redirect" "frame" "text" "form" "canonical" "alternate" "rss" "image"

linked_domains_source_domain:从引用域名链接出去的唯一根域名数量。
类型:integer

linked_domains_source_page:从引用页面链接出去的唯一根域名数量。
类型:integer

linked_domains_target_domain:从目标域名链接出去的唯一根域名数量。
类型:integer

links_external:引用页面的外部链接数量。
类型:integer

links_internal:引用页面的内链数量。
类型:integer

lost_reason:在上次抓取中该链接丢失的原因。
类型:string nullable
枚举:"removedfromhtml" "notcanonical" "noindex" "pageredirected" "pageerror" "lostredirect" "notfound"

name_source:完整的引用域名(包含子域名)。
类型:string

name_target:完整的目标域名(包含子域名)。
类型:string

noindex:引用页面设置了 noindex meta 属性。
类型:boolean

page_category_source:由 AI 预测的引用页面层级分类路径列表,以英文逗号分隔。每个值为以斜杠开头的路径(例如 /Business_and_Industrial/Advertising_and_Marketing/Marketing)。
类型:string nullable

page_size:引用页面内容的大小(字节)。
类型:integer

page_type_source:由 AI 预测的引用页面层级页面类型路径列表,以英文逗号分隔。每个值为以斜杠开头的路径(例如 /Article/How_to)。
类型:string nullable

port_source:引用页面 URL 的网络端口。
类型:integer

port_target:目标页面 URL 的网络端口。
类型:integer

positions:引用页面在前 100 名中有排名的关键词数量。
类型:integer

positions_source_domain:引用域名在前 100 名中有排名的关键词数量。
类型:integer

powered_by:用于构建并提供引用页面内容的 Web 技术。
类型:array(string)

redirect_code:引用页面通过重定向指向你的目标时的 HTTP 状态码。
类型:integer nullable

redirect_kind:目标重定向 URL 或重定向链返回的 HTTP 状态码。
类型:array(integer)

refdomains_source(5 单位):链接到引用页面的唯一引用域名数量。
类型:integer

refdomains_source_domain(5 单位):链接到引用域名的唯一引用域名数量。
类型:integer

refdomains_target_domain(5 单位):链接到目标域名的唯一引用域名数量。
类型:integer

root_name_source:引用域名的根域名(不包含子域名)。
类型:string

root_name_target:目标域名的根域名(不包含子域名)。
类型:string

snippet_left:链接前出现的文本片段。
类型:string

snippet_right:链接后出现的文本片段。
类型:string

source_page_author:引用页面的作者。
类型:string nullable

source_page_publish_date:我们识别该页面发布的日期。
类型:date nullable

title:引用页面的 HTML title。
类型:string

tld_class_source:引用域名的顶级域名类别。
类型:string
枚举:"gov" "edu" "normal"

tld_class_target:目标域名的顶级域名类别。
类型:string
枚举:"gov" "edu" "normal"

traffic(10 单位):引用页面预计每月来自搜索的自然搜索流量。
类型:integer

traffic_domain(10 单位):引用域名预计每月来自搜索的自然搜索流量。
类型:integer

url_from:包含指向你目标链接的页面 URL。
类型:string

url_from_plain:用于过滤的优化版引用页面 URL。
类型:string

url_rating_source:引用页面的反向链接概况强度与我们数据库中其他网站相比的评分,按 0–100 计分。
类型:float

url_redirect:该链接指向的目标 URL 的重定向链。
类型:array(url)

url_redirect_with_target:该链接的目标 URL 及其重定向链。
类型:array(string)

url_to:反向链接指向的 URL。
类型:string

url_to_plain:用于过滤的优化版目标页面 URL。
类型:string

selectstring必填

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

protocolstring

目标的协议。

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

搜索目标:域名或 URL。

modestring

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

允许的值:exactprefixdomainsubdomains
默认:subdomains
aggregationstring

反向链接的分组模式。

允许的值:similar_links1_per_domainall
默认:similar_links
historystring

将丢失的反向链接纳入报告的时间范围。可选择 live(无历史记录)、since:<date>(从指定日期起的历史记录)以及 all_time(全部历史记录)。日期格式应为 YYYY-MM-DD。

默认:all_time
outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

backlinksarray<object>
ahrefs_rank_sourceinteger

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

ahrefs_rank_targetinteger

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

altstring or null

该链接的 alt 属性。

anchorstring

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

broken_redirect_new_targetstring or null

被修改的重定向所指向的新目的地。

broken_redirect_reasonstring or null

上次抓取时,该重定向被判定为失效的原因。

Allowed values:droppedmanualdroppedtooolddroppedcodechangednxdomainrobotsdisallowedcurlerrorinvalidtargetnomorecanonicalisnowparkedtargetchanged
broken_redirect_sourcestring or null

被修改的重定向 URL,导致重定向失效。

class_cinteger

(5 个单位)链接到引用页面的唯一 class_c 子网数量。

discovered_statusstring or null

上次抓取时发现该链接的原因:页面首次被抓取、链接被添加到页面,或链接在被移除后重新出现。

Allowed values:pagefoundlinkfoundlinkrestored
domain_rating_sourcenumber

以 100 分制衡量,与我们数据库中的其他网站相比,引用域名反向链接配置文件的强度。

domain_rating_targetnumber

以 100 分制衡量,与我们数据库中的其他网站相比,引用域名反向链接配置文件的强度。

drop_reasonstring or null

我们将该链接从索引中移除的原因。

Allowed values:manualnoratingunusednotoptoooldoldunavailablerescursiveduplicatenxdomainmalformedblockedportdisallowedunlinked
encodingstring

引用页面 HTML 的字符集编码。

first_seenstring

首次发现引用页面 URL 的日期。

first_seen_linkstring

在指定参考页上首次找到指向目标页面反向链接的日期。

http_codeinteger

抓取引用页面时,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_lostboolean

该链接目前已不存在。

is_newboolean

该链接是在上次抓取时发现的。

is_nofollowboolean

该链接或引用页面设置了Nofollow属性。

is_redirectboolean

通过重定向指向目标的链接。

is_redirect_lostboolean

该重定向链接目前已不存在。

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

最后一次验证指向目标页面的现存链接的日期。

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

引用页面的内链数。

lost_reasonstring or null

链接在上次抓取时丢失的原因。

Allowed values:removedfromhtmlnotcanonicalnoindexpageredirectedpageerrorlostredirectnotfound
name_sourcestring

完整的引用域名,包括子域名。

name_targetstring

完整的目标域名,包括子域名。

noindexboolean

引用页面包含 noindex 元标记。

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

引用页面的作者。

source_page_publish_datestring 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。