> ## 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/dataforseo_labs/google/subdomains/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/dataforseo_labs/google/subdomains/live:
    post:
      summary: 子域名
      description: 此端点将提供指定域名的子域名列表，以及这些子域名在自然搜索和付费搜索中的排名分布。此外，您还将获得基于搜索量和展示次数估算的子域名流量。
      operationId: post_dataforseo_dataforseo_labs_google_subdomains_live
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                target:
                  type: string
                  description: domain 必填字段，目标网站的域名；指定域名时不应包含 https:// 和 www.
                location_name:
                  type: string
                  description: >-
                    位置的完整名称。可选字段。如果使用此字段，则无需指定 location_code。您可以通过向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    单独发送请求，获取包含 location_name
                    的可用位置列表。忽略此字段可获取所有可用位置的结果。示例：United Kingdom
                location_code:
                  type: integer
                  description: >-
                    位置代码，可选字段。如果使用此字段，则无需指定 location_name。您可以通过向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    单独发送请求，获取包含 location_code 的可用位置列表。忽略此字段可获取所有可用位置的结果。示例：2840
                language_name:
                  type: string
                  description: >-
                    语言全名，可选字段。如果使用此字段，则无需指定 language_code。您可以单独向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    发出请求，以获取可用语言及其 language_name
                    的列表。忽略此字段可获取所有可用语言的结果。示例：English
                language_code:
                  type: string
                  description: >-
                    语言代码，可选字段。如果使用此字段，则无需指定 language_name。可以通过向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    单独发起请求，获取包含 language_code 的可用语言列表。忽略此字段可获取所有可用语言的结果。示例：en
                item_types:
                  type: array
                  items:
                    type: string
                  description: >-
                    按项目类型显示结果 可选字段 指示响应中包含的搜索结果类型 注意：如果 item_types 数组包含 organic
                    以外的项目类型，结果将按数组中的第一个项目类型排序；无法按响应中未包含的搜索结果类型对结果进行排序和筛选；可用值：["organic",
                    "paid", "featured_snippet", "local_pack"] 默认值：["organic",
                    "paid"]
                include_clickstream_data:
                  type: boolean
                  description: >-
                    在结果中包含或排除基于点击流的指标数据，可选字段；如果此参数设置为 true，响应中将返回包含点击流数据的
                    clickstream_etv、clickstream_gender_distribution 和
                    clickstream_age_distribution
                    字段。默认值：false。启用此参数后，该请求将按双倍价格收费。有关基于点击流的指标如何计算的更多信息，请参阅此帮助中心文章
                historical_serp_mode:
                  type: string
                  description: >-
                    数据收集模式。可选字段。可使用此字段筛选结果；可用筛选类型：live — 返回指定 target 当前具有排名结果的
                    SERP 指标；lost — 返回指定 target 以前具有排名结果、但在最近一次检查中不再具有排名结果的 SERP
                    指标；all — 返回上述两种 SERP 的指标。默认值：live
                ignore_synonyms:
                  type: boolean
                  description: 忽略高度相似的关键词，可选字段。如果设置为 true，则仅返回核心关键词，并排除所有高度相似的关键词；默认值：false
                filters:
                  type: array
                  items:
                    type: string
                  description: >-
                    结果过滤参数数组，可选字段；可以同时添加多个过滤器（最多 8 个）；应在条件之间设置逻辑运算符
                    and、or；支持以下运算符：regex, not_regex, , , >, >=, =, , in,
                    not_in；示例：["metrics.paid.count",">",0]
                    [["metrics.paid.count",">",0],"and",["metrics.paid.etv",">","50"]]
                    [["metrics.organic.count",">","10"], "and",
                    [["metrics.organic.pos_1","",0],"or",["metrics.organic.pos_2_3","",0]]]；有关过滤器的更多信息，请参阅
                    Dataforseo Labs – Filters 或此帮助中心指南
                order_by:
                  type: array
                  items:
                    type: string
                  description: >-
                    结果排序规则，可选字段。可以使用与 filters 数组中相同的值对结果进行排序。可选排序类型：asc –
                    结果将按升序排列；desc –
                    结果将按降序排列。应使用逗号指定排序类型。示例：["metrics.paid.etv,asc"]。注意：单个请求最多可以设置三条排序规则。应使用逗号分隔多条排序规则。示例：["metrics.organic.etv,desc","metrics.paid.count,asc"]。默认规则：["metrics.organic.count,desc"]。注意：如果
                    item_types 数组包含 organic 以外的项目类型，结果将按数组中的第一个项目类型排序
                limit:
                  type: integer
                  description: 返回的关键词最大数量，可选字段，默认值：100，最大值：1000
                offset:
                  type: integer
                  description: >-
                    返回关键词的结果数组中的偏移量，可选字段，默认值：0。如果指定值
                    10，结果数组中的前十个关键词将被省略，并提供后续关键词的数据
                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.se_type:
                    type: string
                    description: 搜索引擎类型
                  tasks.result.target:
                    type: string
                    description: POST 数组中的域名
                  tasks.result.location_code:
                    type: integer
                    description: POST 数组中的位置代码
                  tasks.result.language_code:
                    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: 包含子域名及相关数据
                  tasks.result.items.se_type:
                    type: string
                    description: 搜索引擎类型
                  tasks.result.items.subdomain:
                    type: string
                    description: 返回的子域名
                  tasks.result.items.metrics:
                    type: object
                    description: 与子域名相关的排名数据
                  tasks.result.items.metrics.organic:
                    type: object
                    description: 自然搜索的排名和流量数据
                  tasks.result.items.metrics.organic.pos_1:
                    type: integer
                    description: '域名排名第 #1 的自然搜索 SERP 数量'
                  tasks.result.items.metrics.organic.pos_2_3:
                    type: integer
                    description: 域名自然搜索结果排名第 2–3 位的数量
                  tasks.result.items.metrics.organic.pos_4_10:
                    type: integer
                    description: 域名排名第 4-10 位的自然搜索结果页数量
                  tasks.result.items.metrics.organic.pos_11_20:
                    type: integer
                    description: 域名排名第 11-20 位的自然搜索结果页数量
                  tasks.result.items.metrics.organic.pos_21_30:
                    type: integer
                    description: 域名排名第 21-30 位的自然搜索结果页数量
                  tasks.result.items.metrics.organic.pos_31_40:
                    type: integer
                    description: 域名排名第 31-40 位的自然搜索结果页数量
                  tasks.result.items.metrics.organic.pos_41_50:
                    type: integer
                    description: 域名排名第 41–50 位的自然搜索结果页数量
                  tasks.result.items.metrics.organic.pos_51_60:
                    type: integer
                    description: 域名排名第 51–60 位的自然搜索结果页数量
                  tasks.result.items.metrics.organic.pos_61_70:
                    type: integer
                    description: '域名排名第 #61-70 位的自然搜索结果数量'
                  tasks.result.items.metrics.organic.pos_71_80:
                    type: integer
                    description: 域名排名第 71-80 位的自然搜索结果页数量
                  tasks.result.items.metrics.organic.pos_81_90:
                    type: integer
                    description: 该域名排名第 81-90 位的自然搜索 SERP 数量
                  tasks.result.items.metrics.organic.pos_91_100:
                    type: integer
                    description: 该域名排名第 91-100 位的自然搜索 SERP 数量
                  tasks.result.items.metrics.organic.etv:
                    type: number
                    description: >-
                      预估流量；域名的预估每月自然搜索流量，计算方式为该域名在相应类别中有排名的所有关键词的
                      CTR（点击率）与搜索量的乘积之和。有关此指标计算方式的更多信息，请参阅此帮助中心文章。
                  tasks.result.items.metrics.organic.count:
                    type: integer
                    description: 包含该域名的自然搜索 SERP 总数
                  tasks.result.items.metrics.organic.estimated_paid_traffic_cost:
                    type: number
                    description: >-
                      将自然搜索流量转化为付费流量的估算成本，表示为某个域名在该类别中有排名的所有关键词投放广告的估算每月成本（USD）；该指标通过
                      organic etv 与 paid cpc 值的乘积计算，表示通过 Google Search 中的 PPC
                      广告获得估算每月自然流量所需的成本。有关该指标如何计算的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.organic.is_new:
                    type: integer
                    description: 新排名元素的数量，表示为指定目标发现了多少个新排名元素
                  tasks.result.items.metrics.organic.is_up:
                    type: integer
                    description: 排名上升，表示指定目标中排名上升的元素数量
                  tasks.result.items.metrics.organic.is_down:
                    type: integer
                    description: 排名下降 表示指定目标中排名下降的元素数量
                  tasks.result.items.metrics.organic.is_lost:
                    type: integer
                    description: 丢失的排名元素；表示所指目标中有多少排名元素此前曾出现在 SERP 中，但在最近一次检查时未被发现
                  tasks.result.items.metrics.organic.clickstream_etv:
                    type: integer
                    description: >-
                      基于点击流数据估算的流量，即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果，必须将参数
                      include_clickstream_data 设置为 true
                      有关此指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.organic.clickstream_gender_distribution:
                    type: object
                    description: >-
                      按性别划分的基于估算点击流的指标分布；要检索此字段的结果，参数 include_clickstream_data
                      必须设置为 true；有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.organic.clickstream_gender_distribution.female:
                    type: integer
                    description: 相关点击流数据集中的女性用户数量
                  tasks.result.items.metrics.organic.clickstream_gender_distribution.male:
                    type: integer
                    description: 相关点击流数据集中的男性用户数量
                  tasks.result.items.metrics.organic.clickstream_age_distribution:
                    type: object
                    description: >-
                      按年龄划分的基于点击流的指标分布。要检索此字段的结果，必须将参数 include_clickstream_data
                      设置为 true。有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.organic.clickstream_age_distribution.18-24:
                    type: integer
                    description: 相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
                  tasks.result.items.metrics.organic.clickstream_age_distribution.25-34:
                    type: integer
                    description: 相关点击流数据集中年龄在 25-34 岁范围内的用户数量
                  tasks.result.items.metrics.organic.clickstream_age_distribution.35-44:
                    type: integer
                    description: 相关点击流数据集中年龄在 35-44 岁范围内的用户数量
                  tasks.result.items.metrics.organic.clickstream_age_distribution.45-54:
                    type: integer
                    description: 相关点击流数据集中年龄在 45-54 岁范围内的用户数量
                  tasks.result.items.metrics.organic.clickstream_age_distribution.55-64:
                    type: integer
                    description: 相关点击流数据集中年龄在 55-64 岁范围内的用户数量
                  tasks.result.items.metrics.paid:
                    type: object
                    description: 付费搜索的排名和流量数据
                  tasks.result.items.metrics.paid.pos_1:
                    type: integer
                    description: 该域名排名第 1 的付费 SERP 数量
                  tasks.result.items.metrics.paid.pos_2_3:
                    type: integer
                    description: '域名排名第 #2-3 位的付费 SERP 数量'
                  tasks.result.items.metrics.paid.pos_4_10:
                    type: integer
                    description: '域名排名第 #4-10 位的付费 SERP 数量'
                  tasks.result.items.metrics.paid.pos_11_20:
                    type: integer
                    description: '域名排名第 #11-20 位的付费 SERP 数量'
                  tasks.result.items.metrics.paid.pos_21_30:
                    type: integer
                    description: 该域名在付费 SERP 中排名第 21-30 位的数量
                  tasks.result.items.metrics.paid.pos_31_40:
                    type: integer
                    description: '域名排名第 #31-40 位的付费 SERP 数量'
                  tasks.result.items.metrics.paid.pos_41_50:
                    type: integer
                    description: '域名排名第 #41-50 位的付费 SERP 数量'
                  tasks.result.items.metrics.paid.pos_51_60:
                    type: integer
                    description: 域名在付费搜索结果页中排名第 51-60 位的数量
                  tasks.result.items.metrics.paid.pos_61_70:
                    type: integer
                    description: '域名排名第 #61-70 位的付费 SERP 数量'
                  tasks.result.items.metrics.paid.pos_71_80:
                    type: integer
                    description: '域名排名第 #71-80 位的付费 SERP 数量'
                  tasks.result.items.metrics.paid.pos_81_90:
                    type: integer
                    description: 域名排名第 81-90 位的付费搜索结果页数量
                  tasks.result.items.metrics.paid.pos_91_100:
                    type: integer
                    description: 域名在付费搜索结果中排名第 91-100 位的 SERP 数量
                  tasks.result.items.metrics.paid.etv:
                    type: number
                    description: >-
                      预估流量；域名的预估每月付费流量，计算方式为该域名在相应类别中有排名的所有关键词的
                      CTR（点击率）与搜索量之乘积。有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.paid.count:
                    type: integer
                    description: 包含该域名的付费 SERP 总数
                  tasks.result.items.metrics.paid.estimated_paid_traffic_cost:
                    type: number
                    description: >-
                      预估每月搜索流量成本表示该域名在相应类别中有排名的所有关键词基于 etv 和 cpc
                      值计算的每月付费流量预估成本（USD）；有关此指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.paid.is_new:
                    type: integer
                    description: 新排名元素的数量，表示为指定目标发现了多少个新排名元素
                  tasks.result.items.metrics.paid.is_up:
                    type: integer
                    description: 排名上升，表示指定目标中排名上升的元素数量
                  tasks.result.items.metrics.paid.is_down:
                    type: integer
                    description: 排名下降 表示指定目标中排名下降的元素数量
                  tasks.result.items.metrics.paid.is_lost:
                    type: integer
                    description: 丢失的排名元素；表示所指目标中有多少排名元素此前曾出现在 SERP 中，但在最近一次检查时未被发现
                  tasks.result.items.metrics.paid.clickstream_etv:
                    type: integer
                    description: >-
                      基于点击流数据估算的流量，即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果，必须将参数
                      include_clickstream_data 设置为 true
                      有关此指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.paid.clickstream_gender_distribution:
                    type: object
                    description: >-
                      按性别划分的基于估算点击流的指标分布；要检索此字段的结果，参数 include_clickstream_data
                      必须设置为 true；有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.paid.clickstream_gender_distribution.female:
                    type: integer
                    description: 相关点击流数据集中的女性用户数量
                  tasks.result.items.metrics.paid.clickstream_gender_distribution.male:
                    type: integer
                    description: 相关点击流数据集中的男性用户数量
                  tasks.result.items.metrics.paid.clickstream_age_distribution:
                    type: object
                    description: >-
                      按年龄划分的基于点击流的指标分布。要检索此字段的结果，必须将参数 include_clickstream_data
                      设置为 true。有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.paid.clickstream_age_distribution.18-24:
                    type: integer
                    description: 相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
                  tasks.result.items.metrics.paid.clickstream_age_distribution.25-34:
                    type: integer
                    description: 相关点击流数据集中年龄在 25-34 岁范围内的用户数量
                  tasks.result.items.metrics.paid.clickstream_age_distribution.35-44:
                    type: integer
                    description: 相关点击流数据集中年龄在 35-44 岁范围内的用户数量
                  tasks.result.items.metrics.paid.clickstream_age_distribution.45-54:
                    type: integer
                    description: 相关点击流数据集中年龄在 45-54 岁范围内的用户数量
                  tasks.result.items.metrics.paid.clickstream_age_distribution.55-64:
                    type: integer
                    description: 相关点击流数据集中年龄在 55-64 岁范围内的用户数量
                  tasks.result.items.metrics.featured_snippet:
                    type: object
                    description: Google SERP 精选摘要结果中的排名和流量数据
                  tasks.result.items.metrics.featured_snippet.pos_1:
                    type: integer
                    description: 该域名排名第 1 的精选摘要项目数量
                  tasks.result.items.metrics.featured_snippet.pos_2_3:
                    type: integer
                    description: 域名排名第 2-3 位的精选摘要条目数量
                  tasks.result.items.metrics.featured_snippet.pos_4_10:
                    type: integer
                    description: '域名排名第 #4-10 位的精选摘要项数量'
                  tasks.result.items.metrics.featured_snippet.pos_11_20:
                    type: integer
                    description: '域名排名第 #11-20 位的精选摘要项数量'
                  tasks.result.items.metrics.featured_snippet.pos_21_30:
                    type: integer
                    description: 域名排名第 21-30 位的精选摘要条目数量
                  tasks.result.items.metrics.featured_snippet.pos_31_40:
                    type: integer
                    description: 域名排名第 31-40 位的精选摘要条目数量
                  tasks.result.items.metrics.featured_snippet.pos_41_50:
                    type: integer
                    description: 该域名排名第 41-50 位的精选摘要项目数量
                  tasks.result.items.metrics.featured_snippet.pos_51_60:
                    type: integer
                    description: 域名排名第 51-60 位的精选摘要条目数量
                  tasks.result.items.metrics.featured_snippet.pos_61_70:
                    type: integer
                    description: '域名排名第 #61-70 位的精选摘要项数量'
                  tasks.result.items.metrics.featured_snippet.pos_71_80:
                    type: integer
                    description: '域名排名第 #71-80 位的精选摘要项数量'
                  tasks.result.items.metrics.featured_snippet.pos_81_90:
                    type: integer
                    description: '域名排名第 #81-90 位的精选摘要项数量'
                  tasks.result.items.metrics.featured_snippet.pos_91_100:
                    type: integer
                    description: '域名排名第 #91-100 位的精选摘要条目数量'
                  tasks.result.items.metrics.featured_snippet.etv:
                    type: number
                    description: >-
                      预估流量；域名的预估每月付费流量，计算方式为该域名在相应类别中有排名的所有关键词的
                      CTR（点击率）与搜索量之乘积。有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.featured_snippet.count:
                    type: integer
                    description: 包含该域名的精选摘要项总数
                  tasks.result.items.metrics.featured_snippet.estimated_paid_traffic_cost:
                    type: number
                    description: >-
                      预估每月搜索流量成本表示该域名在相应类别中有排名的所有关键词基于 etv 和 cpc
                      值计算的每月付费流量预估成本（USD）；有关此指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.featured_snippet.is_new:
                    type: integer
                    description: 新排名元素的数量，表示为指定目标发现了多少个新排名元素
                  tasks.result.items.metrics.featured_snippet.is_up:
                    type: integer
                    description: 排名上升，表示指定目标中排名上升的元素数量
                  tasks.result.items.metrics.featured_snippet.is_down:
                    type: integer
                    description: 排名下降 表示指定目标中排名下降的元素数量
                  tasks.result.items.metrics.featured_snippet.is_lost:
                    type: integer
                    description: 丢失的排名元素；表示所指目标中有多少排名元素此前曾出现在 SERP 中，但在最近一次检查时未被发现
                  tasks.result.items.metrics.featured_snippet.clickstream_etv:
                    type: integer
                    description: >-
                      基于点击流数据估算的流量，即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果，必须将参数
                      include_clickstream_data 设置为 true
                      有关此指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.featured_snippet.clickstream_gender_distribution:
                    type: object
                    description: >-
                      按性别划分的基于估算点击流的指标分布；要检索此字段的结果，参数 include_clickstream_data
                      必须设置为 true；有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.featured_snippet.clickstream_gender_distribution.female:
                    type: integer
                    description: 相关点击流数据集中的女性用户数量
                  tasks.result.items.metrics.featured_snippet.clickstream_gender_distribution.male:
                    type: integer
                    description: 相关点击流数据集中的男性用户数量
                  tasks.result.items.metrics.featured_snippet.clickstream_age_distribution:
                    type: object
                    description: >-
                      按年龄划分的基于点击流的指标分布。要检索此字段的结果，必须将参数 include_clickstream_data
                      设置为 true。有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.featured_snippet.clickstream_age_distribution.18-24:
                    type: integer
                    description: 相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
                  tasks.result.items.metrics.featured_snippet.clickstream_age_distribution.25-34:
                    type: integer
                    description: 相关点击流数据集中年龄在 25-34 岁范围内的用户数量
                  tasks.result.items.metrics.featured_snippet.clickstream_age_distribution.35-44:
                    type: integer
                    description: 相关点击流数据集中年龄在 35-44 岁范围内的用户数量
                  tasks.result.items.metrics.featured_snippet.clickstream_age_distribution.45-54:
                    type: integer
                    description: 相关点击流数据集中年龄在 45-54 岁范围内的用户数量
                  tasks.result.items.metrics.featured_snippet.clickstream_age_distribution.55-64:
                    type: integer
                    description: 相关点击流数据集中年龄在 55-64 岁范围内的用户数量
                  tasks.result.items.metrics.local_pack:
                    type: object
                    description: SERP 本地结果包中的排名和流量数据
                  tasks.result.items.metrics.local_pack.pos_1:
                    type: integer
                    description: 域名排名第 1 位的本地结果包条目数量
                  tasks.result.items.metrics.local_pack.pos_2_3:
                    type: integer
                    description: 该域名排名第 2 至第 3 位的本地结果包项目数量
                  tasks.result.items.metrics.local_pack.pos_4_10:
                    type: integer
                    description: '域名排名第 #4-10 位的本地结果包条目数量'
                  tasks.result.items.metrics.local_pack.pos_11_20:
                    type: integer
                    description: '域名排名第 #11-20 位的本地结果包条目数量'
                  tasks.result.items.metrics.local_pack.pos_21_30:
                    type: integer
                    description: '域名排名第 #21-30 位的本地包结果项数量'
                  tasks.result.items.metrics.local_pack.pos_31_40:
                    type: integer
                    description: '域名排名第 #31-40 位的本地包结果项数量'
                  tasks.result.items.metrics.local_pack.pos_41_50:
                    type: integer
                    description: '域名排名第 #41-50 位的本地包结果项数量'
                  tasks.result.items.metrics.local_pack.pos_51_60:
                    type: integer
                    description: 该域名排名第 51-60 位的本地结果包条目数量
                  tasks.result.items.metrics.local_pack.pos_61_70:
                    type: integer
                    description: '域名排名第 #61-70 位的本地结果包条目数量'
                  tasks.result.items.metrics.local_pack.pos_71_80:
                    type: integer
                    description: 域名排名第 71-80 位的本地结果包项目数量
                  tasks.result.items.metrics.local_pack.pos_81_90:
                    type: integer
                    description: 该域名排名第 81-90 位的本地结果包条目数量
                  tasks.result.items.metrics.local_pack.pos_91_100:
                    type: integer
                    description: 域名排名第 91-100 位的本地包结果项数量
                  tasks.result.items.metrics.local_pack.etv:
                    type: number
                    description: >-
                      预估流量；域名的预估每月付费流量，计算方式为该域名在相应类别中有排名的所有关键词的
                      CTR（点击率）与搜索量之乘积。有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.local_pack.count:
                    type: integer
                    description: 包含该域名的本地结果包条目总数
                  tasks.result.items.metrics.local_pack.estimated_paid_traffic_cost:
                    type: number
                    description: >-
                      预估每月搜索流量成本表示该域名在相应类别中有排名的所有关键词基于 etv 和 cpc
                      值计算的每月付费流量预估成本（USD）；有关此指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.local_pack.is_new:
                    type: integer
                    description: 新排名元素的数量，表示为指定目标发现了多少个新排名元素
                  tasks.result.items.metrics.local_pack.is_up:
                    type: integer
                    description: 排名上升，表示指定目标中排名上升的元素数量
                  tasks.result.items.metrics.local_pack.is_down:
                    type: integer
                    description: 排名下降 表示指定目标中排名下降的元素数量
                  tasks.result.items.metrics.local_pack.is_lost:
                    type: integer
                    description: 丢失的排名元素；表示所指目标中有多少排名元素此前曾出现在 SERP 中，但在最近一次检查时未被发现
                  tasks.result.items.metrics.local_pack.clickstream_etv:
                    type: integer
                    description: >-
                      基于点击流数据估算的流量，即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果，必须将参数
                      include_clickstream_data 设置为 true
                      有关此指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.local_pack.clickstream_gender_distribution:
                    type: object
                    description: >-
                      按性别划分的基于估算点击流的指标分布；要检索此字段的结果，参数 include_clickstream_data
                      必须设置为 true；有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.local_pack.clickstream_gender_distribution.female:
                    type: integer
                    description: 相关点击流数据集中的女性用户数量
                  tasks.result.items.metrics.local_pack.clickstream_gender_distribution.male:
                    type: integer
                    description: 相关点击流数据集中的男性用户数量
                  tasks.result.items.metrics.local_pack.clickstream_age_distribution:
                    type: object
                    description: >-
                      按年龄划分的基于点击流的指标分布。要检索此字段的结果，必须将参数 include_clickstream_data
                      设置为 true。有关该指标计算方式的更多信息，请参阅此帮助中心文章
                  tasks.result.items.metrics.local_pack.clickstream_age_distribution.18-24:
                    type: integer
                    description: 相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
                  tasks.result.items.metrics.local_pack.clickstream_age_distribution.25-34:
                    type: integer
                    description: 相关点击流数据集中年龄在 25-34 岁范围内的用户数量
                  tasks.result.items.metrics.local_pack.clickstream_age_distribution.35-44:
                    type: integer
                    description: 相关点击流数据集中年龄在 35-44 岁范围内的用户数量
                  tasks.result.items.metrics.local_pack.clickstream_age_distribution.45-54:
                    type: integer
                    description: 相关点击流数据集中年龄在 45-54 岁范围内的用户数量
                  tasks.result.items.metrics.local_pack.clickstream_age_distribution.55-64:
                    type: integer
                    description: 相关点击流数据集中年龄在 55-64 岁范围内的用户数量
        '400':
          description: 错误请求
        '401':
          description: 未授权
        '429':
          description: 超出速率限制
        '500':
          description: 内部服务器错误
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````