> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 域名页面

> 此端点将为您提供域名页面的详细概览，包括每个页面的反向链接数据。



## OpenAPI

````yaml openapi/zh/dataforseo.json POST /dataforseo/backlinks/domain_pages/live
openapi: 3.0.3
info:
  title: DataForSEO API
  version: 1.0.0
  description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /dataforseo/backlinks/domain_pages/live:
    post:
      summary: 域名页面
      description: 此端点将为您提供域名页面的详细概览，包括每个页面的反向链接数据。
      operationId: post_dataforseo_backlinks_domain_pages_live
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                target:
                  type: string
                  description: 域名或子域名，必填字段；应指定不包含 https:// 和 www. 的域名或子域名。示例：forbes.com
                limit:
                  type: integer
                  description: 返回页面的最大数量，可选字段，默认值：100，最大值：1000
                offset:
                  type: integer
                  description: >-
                    返回的页面在结果数组中的偏移量。可选字段。默认值：0。如果指定值
                    10，结果数组中的前十个页面将被忽略，并提供后续页面的数据
                internal_list_limit:
                  type: integer
                  description: >-
                    内部数组中的最大元素数量；可选字段；您可以使用此字段限制以下数组中的元素数量：referring_links_tld
                    referring_links_types referring_links_attributes
                    referring_links_platform_types
                    referring_links_semantic_locations；默认值：10；最大值：1000
                backlinks_status_type:
                  type: string
                  description: >-
                    设置要返回和计数的反向链接；可选字段；您可以使用此字段选择将返回并用于聚合指标的反向链接；可选值：all –
                    返回并统计所有反向链接；live – 返回并统计上次检查期间发现的反向链接；lost –
                    返回并统计已丢失的反向链接；默认值：live
                filters:
                  type: array
                  items:
                    type: string
                  description: >-
                    结果过滤参数数组，可选字段。可以同时添加多个过滤器（最多 8 个）。应在条件之间设置逻辑运算符
                    and、or。支持以下运算符：regex、not_regex、=、
                    、in、not_in、like、not_like、ilike、not_ilike、match、not_match。可以将
                    % 运算符与 like 和 not_like
                    配合使用，以匹配由零个或多个字符组成的任意字符串。示例：["meta.internal_links_count",">","1"]
                    [["meta.external_links_count",">","2"], "and",
                    ["backlinks",">","10"]] [["first_visited",">","2017-10-23
                    11:31:45 +00:00"], "and",
                    [["title","like","%seo%"],"or",["referring_domains",">","10"]]]。完整的可用过滤器列表可在此处查看。
                order_by:
                  type: array
                  items:
                    type: string
                  description: >-
                    结果排序规则；可选字段；您可以使用与 filters 数组中相同的值对结果进行排序；可用的排序类型：asc –
                    结果将按升序排列；desc –
                    结果将按降序排列；应使用逗号设置排序类型；示例：["page_summary.backlinks,desc"]；请注意，单个请求最多可设置三条排序规则；应使用逗号分隔多条排序规则；示例：["page_summary.backlinks,desc","page_summary.rank,asc"]
                backlinks_filters:
                  type: array
                  items:
                    type: string
                  description: >-
                    目标反向链接过滤器，可选字段。您可以使用此字段筛选将纳入数据集、用于计算目标聚合指标的初始反向链接。您可以按此端点响应中提供的所有字段筛选反向链接。使用此参数，您可以仅在响应中包含
                    dofollow 反向链接，并创建灵活的反向链接数据集来计算指标。例如："backlinks_filters":
                    ["dofollow", "=", true]
                include_subdomains:
                  type: boolean
                  description: 指示搜索是否包含目标的子域名。可选字段。如果设为 false，将忽略子域名。默认值：true
                exclude_internal_backlinks:
                  type: boolean
                  description: >-
                    指示是否从结果中排除子域名指向目标的内部反向链接；可选字段；如果设置为 true，结果将不包含与 target
                    同一域名下的子域名所产生的内部反向链接数据；如果设置为 false，结果将包含内部链接；默认值：true
                rank_scale:
                  type: string
                  description: >-
                    定义用于计算和显示 rank、domain_from_rank 和 page_from_rank
                    值的刻度，可选字段。可以使用此参数选择以 0–100 或 0–1000 刻度显示排名值。可用值：one_hundred
                    — 排名值以 0–100 刻度显示；one_thousand — 排名值以 0–1000
                    刻度显示。默认值：one_thousand。有关此参数的工作方式及排名指标计算方法的更多信息，请参阅此帮助中心文章
                tag:
                  type: string
                  description: >-
                    用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data
                    对象中找到指定的 tag 值
              required:
                - target
      responses:
        '200':
          description: 成功响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    type: string
                    description: API 的当前版本
                  status_code:
                    type: integer
                    description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况
                  status_message:
                    type: string
                    description: 常规信息消息；可在此处查看常规信息消息的完整列表
                  time:
                    type: string
                    description: 执行时间（秒）
                  cost:
                    type: number
                    description: 任务总成本（美元）
                  tasks_count:
                    type: integer
                    description: tasks 数组中的任务数量
                  tasks_error:
                    type: integer
                    description: 返回错误的 tasks 数组中的任务数量
                  tasks:
                    type: array
                    items:
                      type: string
                    description: 任务数组
                  tasks.id:
                    type: string
                    description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符
                  tasks.status_code:
                    type: integer
                    description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看
                  tasks.status_message:
                    type: string
                    description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表
                  tasks.time:
                    type: string
                    description: 执行时间（秒）
                  tasks.cost:
                    type: number
                    description: 任务成本（美元）
                  tasks.result_count:
                    type: integer
                    description: 结果数组中的元素数量
                  tasks.path:
                    type: array
                    items:
                      type: string
                    description: URL 路径
                  tasks.data:
                    type: object
                    description: 包含您在 POST 请求中指定的相同参数
                  tasks.result:
                    type: array
                    items:
                      type: string
                    description: 结果数组
                  tasks.result.target:
                    type: string
                    description: POST 数组中的目标
                  tasks.result.total_count:
                    type: integer
                    description: 数据库中相关项目的总数
                  tasks.result.items_count:
                    type: integer
                    description: items 数组中的项目数量
                  tasks.result.items:
                    type: array
                    items:
                      type: string
                    description: items 数组
                  tasks.result.items.type:
                    type: string
                    description: 元素类型 = ‘backlinks_domain_page’
                  tasks.result.items.main_domain:
                    type: string
                    description: 主网站域名；主网站域名不包括子域名
                  tasks.result.items.domain:
                    type: string
                    description: 找到该页面的域名
                  tasks.result.items.tld:
                    type: string
                    description: 顶级域名，即 DNS 根区域中的顶级域名
                  tasks.result.items.page:
                    type: string
                    description: 页面 URL，相关页面的 URL
                  tasks.result.items.ip:
                    type: string
                    description: 互联网协议地址
                  tasks.result.items.first_visited:
                    type: string
                    description: >-
                      首次访问页面的日期和时间，即爬虫首次访问此页面的日期和时间；UTC 格式：“yyyy-mm-dd hh-mm-ss
                      +00:00”；示例：2017-01-24 13:20:59 +00:00
                  tasks.result.items.prev_visited:
                    type: string
                    description: >-
                      在最近一次之前，我们的爬虫访问该页面的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss
                      +00:00” 示例：2017-01-24 13:20:59 +00:00
                  tasks.result.items.fetch_time:
                    type: string
                    description: >-
                      爬虫最近一次访问该页面的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss
                      +00:00”；示例：2017-01-24 13:20:59 +00:00
                  tasks.result.items.status code:
                    type: integer
                    description: 页面的 HTTP 状态码
                  tasks.result.items.location:
                    type: string
                    description: location 标头指示页面重定向到的 URL（如果存在）
                  tasks.result.items.size:
                    type: integer
                    description: 指示页面大小，以字节为单位
                  tasks.result.items.encoded_size:
                    type: integer
                    description: 编码后的页面大小，表示编码后页面的大小，单位为字节
                  tasks.result.items.content_encoding:
                    type: string
                    description: 编码类型
                  tasks.result.items.media_type:
                    type: string
                    description: 用于显示页面的媒体类型
                  tasks.result.items.server:
                    type: string
                    description: 服务器版本
                  tasks.result.items.meta:
                    type: object
                    description: 页面元数据
                  tasks.result.items.meta.title:
                    type: string
                    description: 页面标题
                  tasks.result.items.meta.canonical:
                    type: string
                    description: 规范页面
                  tasks.result.items.meta.internal_links_count:
                    type: integer
                    description: 页面上的内部链接数量
                  tasks.result.items.meta.external_links_count:
                    type: integer
                    description: 页面上的外部链接数量
                  tasks.result.items.meta.images_count:
                    type: integer
                    description: 页面上的图片数量
                  tasks.result.items.meta.words_count:
                    type: integer
                    description: 页面上的字数
                  tasks.result.items.meta.page_spam_score:
                    type: integer
                    description: 页面的垃圾内容评分；有关该指标计算方式的更多信息，请参阅此帮助中心页面
                  tasks.result.items.meta.social_media_tags:
                    type: object
                    description: >-
                      页面上发现的社交媒体标签数组，包含社交媒体标签及其内容。支持的标签包括但不限于 Open Graph 和
                      Twitter card
                  tasks.result.items.meta.h1:
                    type: array
                    items:
                      type: string
                    description: h1 标签的内容
                  tasks.result.items.meta.h2:
                    type: array
                    items:
                      type: string
                    description: h2 标签的内容
                  tasks.result.items.meta.h3:
                    type: array
                    items:
                      type: string
                    description: h3 标签的内容
                  tasks.result.items.meta.images_alt:
                    type: array
                    items:
                      type: string
                    description: alt 标签的内容
                  tasks.result.items.meta.powered_by:
                    type: array
                    items:
                      type: string
                    description: CMS 详情
                  tasks.result.items.meta.language:
                    type: string
                    description: 页面内容语言，示例：en
                  tasks.result.items.meta.charset:
                    type: string
                    description: 字符编码示例：utf-8
                  tasks.result.items.meta.platform_type:
                    type: array
                    items:
                      type: string
                    description: 平台类型
                  tasks.result.items.meta.technologies:
                    type: object
                    description: 网站技术
                  tasks.result.items.meta.technologies.cms:
                    type: string
                    description: 内容管理系统
                  tasks.result.items.meta.technologies.blogs:
                    type: string
                    description: 博客管理系统
                  tasks.result.items.meta.technologies.cdn:
                    type: string
                    description: 内容分发网络
                  tasks.result.items.page_summary:
                    type: object
                    description: 包含此页面的反向链接数据
                  tasks.result.items.page_summary.first_seen:
                    type: string
                    description: >-
                      我们的爬虫首次发现该反向链接的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss
                      +00:00” 示例：2019-11-15 12:57:46 +00:00
                  tasks.result.items.page_summary.lost_date:
                    type: string
                    description: >-
                      此页面最后一个反向链接丢失的日期和时间，表示爬虫访问该页面且页面返回 4xx 或 5xx
                      状态码的日期和时间，或者最后一个反向链接被移除的日期和时间。采用 UTC 格式：“yyyy-mm-dd
                      hh-mm-ss +00:00”。示例：2017-01-24 13:20:59 +00:00
                  tasks.result.items.page_summary.rank:
                    type: integer
                    description: >-
                      页面排名；页面排名基于链接数据库中的节点排名方法计算，该原理应用于最初的 Google PageRank
                      算法；有关此指标及其计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.page_summary.backlinks:
                    type: integer
                    description: 表示反向链接的数量
                  tasks.result.items.page_summary.backlinks_spam_score:
                    type: integer
                    description: 指向该页面的反向链接的平均垃圾评分；可在此帮助中心页面了解有关该指标计算方式的更多信息
                  tasks.result.items.page_summary.broken_backlinks:
                    type: integer
                    description: 失效反向链接数量，即指向该页面的失效反向链接数量
                  tasks.result.items.page_summary.broken_pages:
                    type: integer
                    description: 失效页面数量，即反向链接所指向的、返回 4xx 或 5xx 状态码的页面数量
                  tasks.result.items.page_summary.referring_domains:
                    type: integer
                    description: 表示引用域名的数量
                  tasks.result.items.page_summary.referring_domains_nofollow:
                    type: integer
                    description: 至少有一个 nofollow 链接指向该页面的域名数量
                  tasks.result.items.page_summary.referring_main_domains:
                    type: integer
                    description: 指示引用主域名的数量
                  tasks.result.items.page_summary.referring_main_domains_nofollow:
                    type: integer
                    description: 至少有一个 nofollow 链接指向该页面的主域名数量
                  tasks.result.items.page_summary.referring ips:
                    type: integer
                    description: 引用 IP 地址数量，即指向此页面的 IP 地址数量
                  tasks.result.items.page_summary.referring subnets:
                    type: integer
                    description: 引用子网数量
                  tasks.result.items.page_summary.referring_pages:
                    type: integer
                    description: 表示指向该页面的页面数量
                  tasks.result.items.page_summary.referring_links_tld:
                    type: object
                    description: 引荐链接的顶级域名，包含各顶级域名及其对应的引荐链接数量
                  tasks.result.items.page_summary.referring_links_types:
                    type: object
                    description: >-
                      引荐链接类型，表示引荐链接的类型及每种类型的链接数量。可选值：anchor、image、link、meta、canonical、alternate、redirect
                  tasks.result.items.page_summary.referring_links_attributes:
                    type: object
                    description: 引荐链接的链接属性，表示引荐链接的链接属性以及每种属性对应的链接数量
                  tasks.result.items.page_summary.referring_links_platform_types:
                    type: object
                    description: >-
                      引荐平台类型，表示引荐平台的类型以及各平台的链接数量。可选值：cms、blogs、ecommerce、message-boards、wikis、news、organization
                  tasks.result.items.page_summary.referring_links_semantic_locations:
                    type: object
                    description: >-
                      引荐链接的语义位置，表示引荐链接所在的 HTML
                      语义元素，以及每个语义位置的链接数量；可在此处获取完整的语义元素列表。示例：article、section、summary
                  tasks.result.items.page_summary.referring_links_countries:
                    type: object
                    description: 引用链接的 ISO 国家/地区代码，表示引用链接所在域名的 ISO 国家/地区代码以及每个国家/地区的链接数量
                  tasks.result.items.page_summary.referring_pages_nofollow:
                    type: integer
                    description: 至少有一个 nofollow 链接指向该页面的引用页面数量
        '400':
          description: 错误请求
        '401':
          description: 未授权
        '429':
          description: 超出速率限制
        '500':
          description: 内部服务器错误
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````