Skip to main content
POST
域名交集
同时链向多个目标的域名。⚠️ 这里的 targets按位置作键的对象——{"1": "a.com", "2": "b.com"},不是 bulk 系列用的数组。exclude_targets 可把某些站排除出比较。每行含 domain_intersection 和每个目标一份 summary。单行实测 2.0 KB。响应包在 DataForSEO 的信封里:数据在 tasks[0].result,上游扣费在 tasks[0].cost,成败在 tasks[0].status_code——请求被拒时 HTTP 仍是 200。 用它找「链了你竞品但没链你」的域名。页面级的对应接口是 post_dataforseo_backlinks_page_intersection_live。💰 本家族每个端点实测上游 $0.024,是我们收费的两倍——limit 压低,别循环调。

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
targets
object
必填

要获取链接的域名、子域名或网页;必填字段。最多可设置 20 个域名、子域名或网页。域名或子域名应省略 https:// 和 www.;网页应使用绝对 URL(包括 http:// 或 https://)。示例:"targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }

exclude_targets
string[]

要排除的域名、子域名或网页,可选字段。最多可以指定 10 个域名、子域名或网页。如果使用此数组,结果将包含链接到 targets 但未链接到 exclude_targets 的引荐域名。示例:"exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/", "https://dataforseo.com/apis/"]

filters
string[]

结果筛选参数数组,可选字段。可以同时添加多个筛选条件(最多 8 个),条件之间应设置逻辑运算符 and、or。支持以下运算符:regex, not_regex, =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match。可以将 % 运算符与 like 和 not_like 搭配使用,以匹配包含零个或多个字符的任意字符串。示例:["1.internal_links_count",">","1"] [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]] [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]] 可用筛选条件的完整列表请参见此处。

order_by
string[]

结果排序规则 可选字段 可使用与 filters 数组中相同的值对结果进行排序 可用的排序类型:asc – 结果将按升序排列 desc – 结果将按降序排列 应使用逗号设置排序类型 示例:["backlinks,desc"] 请注意,单个请求中最多可设置三条排序规则 应使用逗号分隔多条排序规则 示例:["backlinks,desc","rank,asc"]

offset
integer

返回结果数组的偏移量,可选字段。默认值:0。如果指定值 10,结果数组中的前十个反向链接将被省略,并提供后续反向链接的数据

limit
integer

返回结果的最大数量,可选字段,默认值:100,最大值:1000

internal_list_limit
integer

内部数组中的最大元素数量;可选字段;您可以使用此字段限制以下数组中的元素数量:referring_links_tld referring_links_types referring_links_attributes referring_links_platform_types referring_links_semantic_locations;默认值:10;最大值:1000

设置要返回和计数的反向链接。可选字段。您可以使用此字段选择将返回哪些反向链接,以及使用哪些反向链接计算目标的汇总指标;可选值:all – 返回并计数所有反向链接;live – 返回并计数上次检查期间发现的反向链接;lost – 返回并计数已丢失的反向链接;默认值:live

筛选目标的反向链接 可选字段 可以使用此字段筛选将纳入数据集的初始反向链接,以计算目标的聚合指标 可以通过此端点响应中的所有可用字段筛选反向链接 使用此参数,可以仅在响应中包含 dofollow 反向链接,并创建灵活的反向链接数据集以计算指标 示例:"backlinks_filters": [["dofollow", "=", true]]

include_subdomains
boolean

指示搜索是否包含目标的子域名。可选字段。如果设为 false,将忽略子域名。默认值:true

指示结果中是否包含指向目标的间接链接;可选字段;如果设置为 true,结果将包含指向以下页面的间接链接数据:重定向到目标的页面,或指向规范页面的页面;如果设置为 false,将忽略间接链接;默认值:true

指示是否排除来自目标子域名的反向链接,可选字段。如果设置为 false,则会省略来自目标子域名的反向链接,并且响应中不会返回相同域名;默认值:true

intersection_mode
string

指示是否对反向链接取交集;可选字段。使用此字段可对指定域名的结果取交集或合并。可能的值:all、partial。all – 结果基于所有反向链接;partial – 结果仅基于相交的反向链接;默认值:all

rank_scale
string

定义用于计算和显示 rank、domain_from_rank 和 page_from_rank 值的刻度,可选字段。可以使用此参数选择以 0–100 或 0–1000 刻度显示排名值。可用值:one_hundred — 排名值以 0–100 刻度显示;one_thousand — 排名值以 0–1000 刻度显示。默认值:one_thousand。有关此参数的工作方式及排名指标计算方法的更多信息,请参阅此帮助中心文章

tag
string

用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值

响应

成功响应

version
string

API 的当前版本

status_code
integer

通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况

status_message
string

常规信息消息;可在此处查看常规信息消息的完整列表

time
string

执行时间(秒)

cost
number

任务总成本(美元)

tasks_count
integer

tasks 数组中的任务数量

tasks_error
integer

返回错误的 tasks 数组中的任务数量

tasks
string[]

任务数组

tasks.id
string

任务标识符,系统中采用 UUID 格式的唯一任务标识符

tasks.status_code
integer

DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看

tasks.status_message
string

任务的信息性消息,你可以在此处查看通用信息性消息的完整列表

tasks.time
string

执行时间(秒)

tasks.cost
number

任务成本(美元)

tasks.result_count
integer

结果数组中的元素数量

tasks.path
string[]

URL 路径

tasks.data
object

包含您在 POST 请求中指定的相同参数

tasks.result
string[]

结果数组

tasks.result.targets
object

POST 数组中的目标域名、子域名或网页

tasks.result.total_count
integer

与请求相关的结果总数

tasks.result.items_count
integer

items 数组中返回的结果数量

tasks.result.items
string[]

包含链接到 POST 数组中所有目标的域名

tasks.result.items.domain_intersection
object

包含链接到 POST 数组中指定相应目标的域名数据 数据在与 targets 对象中指定的域名、子域名或网页对应的独立对象中提供

tasks.result.items.1
object

包含链接到 POST 数组中相应目标的域名数据 字段名称根据 targets 对象中的域名、子域名或网页数量,在 1 到 20 范围内变化

tasks.result.items.1.type
string

元素类型 = ‘backlinks_domain_intersection’

tasks.result.items.1.target
string

链接到 POST 数组中相应目标的域名

tasks.result.items.1.rank
integer

从 POST 数组中的目标获得的引用排名,表示引用域(即上述 target)引用 POST 数组中目标的排名;rank 根据链接数据库中的节点排名方法计算,该原理曾用于最初的 Google PageRank 算法。有关此指标及其计算方式的更多信息,请参阅这篇帮助中心文章

表示反向链接的数量

tasks.result.items.1.first_seen
string

爬虫首次发现来自此目标的反向链接的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”,示例:2019-11-15 12:57:46 +00:00

tasks.result.items.1.lost_date
integer

此目标的最后一个反向链接丢失的日期和时间,表示我们的爬虫访问该页面且页面返回 4xx 或 5xx 状态码,或者最后一个反向链接被移除的日期和时间;UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

指向目标的反向链接的平均垃圾评分;如需详细了解该指标的计算方式,请参阅此帮助中心页面

失效反向链接数量

tasks.result.items.1.broken_pages
integer

失效页面数量

tasks.result.items.1.referring_domains
integer

引用域名数量

tasks.result.items.1.referring_domains_nofollow
integer

至少有一个 nofollow 链接指向相应目标的域名数量

tasks.result.items.1.referring_main_domains
integer

引用主域名数量

tasks.result.items.1.referring_main_domains_nofollow
integer

至少有一个 nofollow 链接指向目标的主域名数量

tasks.result.items.1.referring_ips
integer

引荐 IP 地址数量

tasks.result.items.1.referring_subnets
integer

引用子网数量

tasks.result.items.1.referring_pages
integer

表示指向目标的页面数量

引荐链接的顶级域名,包含各顶级域名及其对应的引荐链接数量

引荐链接类型,表示引荐链接的类型以及每种类型的链接数量。可能的值:anchor、image、link、meta、canonical、alternate、redirect

引用链接的链接属性,表示引用链接的链接属性以及每种属性对应的链接数量

引荐平台类型,表示引荐平台的类型及各平台的链接数量。可选值:cms、blogs、ecommerce、message-boards、wikis、news、organization

引用链接的语义位置,指示引用链接所在的 HTML 语义元素,以及每个语义位置的链接数量。可在此处获取完整的语义元素列表

引用链接的 ISO 国家/地区代码,表示引用链接所在域名的 ISO 国家/地区代码以及每个国家/地区的链接数量

tasks.result.items.1.referring_pages_nofollow
integer

至少有一个 nofollow 链接指向目标的引用页面数量

tasks.result.items.summary
object

包含域名交集摘要

tasks.result.items.intersections_count
integer

交集总数