Google 域名交集（实时接口）

POST /v3/dataforseo_labs/google/domain_intersection/live

本接口使用 POST 方法，路径为：

/v3/dataforseo_labs/google/domain_intersection/live

用于查询两个指定域名在 Google 同一 SERP 中排名的，并返回搜索量、竞争度、每次点击费用、难度、搜索意图，以及两个域名对应的 SERP素、预估流量和付费流量成本等数据。

本接口支持以下 SERP 类型：

自然搜索结果（organic）
付费搜索结果（paid）
本地结果（local_pack）
精选摘要（featured_snippet）

数据通常每周更新，最新更新时间可通过 /v3/dataforseo_labs/status/ 查询。

请求信息

请求方法： POST
请求路径： /v3/dataforseo_labs/google/domain_intersection/live
请求地址： https://api.seermartech.cn/v3/dataforseo_labs/google/domain_intersection/live
Content-Type： application/json
请求体格式： JSON 数组，数组中每次只能一个任务
并发限制： 最多同时提交 30 个请求平台限流以认证说明中的 30/60/120 次/分钟规则为准

每个实时接口请求只能提交一个任务，任务放在通用 POST 数组中。

计费说明

每次请求都会产生费用。启用 include_clickstream_data: true 时，请求费用按基础费用的 2 倍计算。

参考价约 ¥0.0750 / 次（以示例中的单任务费用折算供参考）。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

任务级参数

参数	类型	填	说明
`target1`	string	是	第一个目标域名。不要 `https://` 或 `www.`，例如 `cnn.com`。
`target2`	string	是	第二个目标域名。不要 `https://` 或 `www.`，例如 `forbes.com`。
`location_name`	string	条件填	地理位置名。未指定 `location_code` 时填。与 `location_code` 二选一。
`location_code`	integer	条件填	地理位置代码。未指定 `location_name` 时填。与 `location_name` 二选一。
`language_name`	string	条件填	语言名。未指定 `language_code` 时填。与 `language_code` 二选一。
`language_code`	string	条件填	语言代码。未指定 `language_name` 时填。与 `language_name` 二选一。
`intersections`	boolean	否	是否返回两个域名在同一 SERP 中出现的。默认值为 `true`。
`item_types`	array	否	指定返回的搜索结果类型。可使用 `organic`、`paid`、`local_pack`、`featured_snippet`。默认返回支持的类型。
`include_serp_info`	boolean	否	是否返回每个的 SERP 数据结果总数、检查地址和 SERP素类型。默认值为 `false`。
`include_clickstream_data`	boolean	否	是否返回基于点击流数据计算的指标。默认值为 `false`。
`limit`	integer	否	返回的最大数量。默认值为 `100`，最大值为 `1000`。
`offset`	integer	否	结果偏移量，默认值为 `0`。例如设置为 `10` 时，将跳过前 10 条结果。
`filters`	array	否	结果过滤条件。最多设置 8 个过滤条件。
`order_by`	array	否	结果排序规则。最多设置 3 条排序规则。
`tag`	string	否	用户自定义任务标识，最长 255 个字符。该值会原样返回在响应的 `data` 对象中。

地理位置和语言

可通过以下接口获取可用的地理位置和语言：

https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages

示例：

json

{
  "location_name": "United Kingdom",
  "location_code": 2840,
  "language_name": "English",
  "language_code": "en"
}

`intersections` 参数说明

当设置为 true 时：

返回 target1 和 target2 在同一 SERP 中均有排名的；
返回两个域名各自对应的 SERP素；
如果交集数量 1000 万条，则不会返回结果。

当设置为 false 时：

返回 target1 有排名、target2 没有排名的；
返回 target1 对应的 SERP素。

`filters` 过滤器

支持的运算符：

regex、not_regex、<、<=、>、>=、=、<>、in、not_in、match、not_match、ilike、not_ilike、like、not_like

多个条件之间使用逻辑运算符 and 或 or 连接。like、not_like、ilike 和 not_ilike 支持 % 通符。

示例：筛选第一个域名预估流量大于 0，且难度小于 60 的结果。

json

[
  ["first_domain_serp_element.etv", ">", 0],
  "and",
  ["keyword_data.keyword_info.keyword_difficulty", "<", 60]
]

`order_by` 排序

排序格式为：

json

["字段名", "asc"]

：

asc：升序
desc：降序

示例：

json

[
  ["keyword_data.keyword_info.search_volume", "desc"],
  ["first_domain_serp_element.rank_absolute", "asc"]
]

请求示例

curl

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/dataforseo_labs/google/domain_intersection/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "target1": "cnn.com",
      "target2": "forbes.com",
      "language_name": "English",
      "location_code": 2840,
      "intersections": true,
      "include_serp_info": true,
      "limit": 3,
      "filters": [
        ["first_domain_serp_element.etv", ">", 0]
      ],
      "order_by": [
        ["keyword_data.keyword_info.search_volume", "desc"]
      ],
      "tag": "domain-intersection-demo"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/google/domain_intersection/live"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

post_data = [
    {
        "target1": "cnn.com",
        "target2": "forbes.com",
        "location_name": "United States",
        "language_name": "English",
        "filters": [
            ["first_domain_serp_element.etv", ">", 0]
        ],
        "limit": 3,
    }
]

response = requests.post(url, headers=headers, json=post_data)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，状态码：%s，消息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

typescript

import axios from "axios";

const postData = [
  {
    target1: "cnn.com",
    target2: "forbes.com",
    language_name: "English",
    location_code: 2840,
    filters: [
      ["first_domain_serp_element.etv", ">", 0],
    ],
    limit: 3,
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/dataforseo_labs/google/domain_intersection/live",
    postData,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error.response?.data || error.message);
  });

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

json

{
  "version": "0.1.20240801",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "11.0816 sec.",
  "cost": 0.0103,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": " e1d7a6c5-1234-4bcd-8abc-123456789abc",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "10.9521 sec.",
      "cost": 0.0103,
      "result_count": 1,
      "data": {
        "api": "dataforseo_labs",
        "function": "domain_intersection",
        "se_type": "google",
        "target1": "mom.com",
        "target2": "quora.com",
        "language_code": "en",
        "location_code": 2840,
        "include_serp_info": true,
        "limit": 3
      },
      "result": [
        {
          "se_type": "google",
          "target1": "mom.com",
          "target2": "quora.com",
          "location_code": 2840,
          "language_code": "en",
          "total_count": 3,
          "items_count": 3,
          "items": []
        }
      ]
    }
  ]
}

> 示例中的 cost 字段保留平台容格式。人民币扣费请以响应头 X-SeerMarTech-Charge-CNY 为准。

顶层响应字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	请求总体状态码。`20000` 表示成功。
`status_message`	string	请求总体状态消息。
`time`	string	请求执行耗时，例如 `11.0816 sec.`。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务总数。
`tasks_error`	integer	返回错误的任务数量。
`tasks`	array	任务结果数组。

`tasks` 任务字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，通常在 `10000` 到 `60000` 范围。
`status_message`	string	任务状态消息。
`time`	string	任务执行耗时。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的数量。
`path`	array	当前请求的 URL 路径。
`data`	object	创建任务时提交的参数。
`result`	array	当前任务的结果数组。

`result` 结果字段

字段	类型	说明
`se_type`	string	搜索引擎类型，固定为 `google`。
`target1`	string	第一个目标域名。
`target2`	string	第二个目标域名。
`location_code`	integer	地理位置代码。
`language_code`	string	语言代码。
`total_count`	integer	数据库中符合请求条件的结果总数。
`items_count`	integer	本次返回的数量。
`items`	array	、SERP素及指标。

`items` 结果

基础字段

字段	类型	说明
`se_type`	string	搜索引擎类型。
`keyword_data`	object	当前的数据。
`first_domain_serp_element`	object	第一个域名对应的 SERP素。
`second_domain_serp_element`	object	第二个域名对应的 SERP素。

`keyword_data`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`keyword`	string	文本。
`location_code`	integer	地理位置代码。
`language_code`	string	语言代码。
`keyword_info`	object	搜索量、竞争度和广告出价等指标。
`clickstream_keyword_info`	object	点击流数据。在 `include_clickstream_data` 为 `true` 时返回。
`keyword_properties`	object	属性和难度。
`serp_info`	object	SERP 数据。在 `include_serp_info` 为 `true` 且存在对应数据时返回。
`avg_backlinks_info`	object	排名前 10 个自然结果的平均外链指标。
`search_intent_info`	object	搜索意图数据。
`keyword_info_normalized_with_bing`	object	使用 Bing 搜索量归一化后的数据。
`keyword_info_normalized_with_clickstream`	object	使用点击流数据归一化后的数据。

`keyword_info`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`last_updated_time`	string	数据更新时间，UTC 格式：`yyyy-mm-dd hh:mm:ss +00:00`。
`competition`	float	广告竞争度，取值范围为 `0` 到 `1`。
`competition_level`	string/null	付费 SERP 竞争等级：`LOW`、`MEDIUM`、`HIGH`。未知时为 `null`。
`cpc`	float	历史平均每次点击费用。
`search_volume`	integer	Google 月均搜索量。
`low_top_of_page_bid`	float	广告展示在首页顶部所需的较低参考出价。
`high_top_of_page_bid`	float	广告展示在首页顶部所需的较高参考出价。
`categories`	array	产品或服务分类。
`monthly_searches`	array	最近 12 个月的月度搜索量。
`search_volume_trend`	object	搜索量趋势变化。

search_volume_trend 字段：

字段	类型	说明
`monthly`	integer	与上月相比的搜索量变化百分比。
`quarterly`	integer	与上一季度相比的搜索量变化百分比。
`yearly`	integer	与上年同期相比的搜索量变化百分比。

monthly_searches 数组：

字段	类型	说明
`year`	integer	年份。
`month`	integer	月份。
`search_volume`	integer	该月搜索量。

`clickstream_keyword_info`

在 include_clickstream_data 设置为 true 时返回。

字段	类型	说明
`search_volume`	integer	基于点击流数据估算的月均搜索量。
`last_updated_time`	string	点击流数据更新时间。
`gender_distribution`	object	用户性别分布。
`age_distribution`	object	用户年龄分布。
`monthly_searches`	array	基于点击流数据的月度搜索量。

gender_distribution：

female：女性用户数量
male：男性用户数量

age_distribution：

18-24
25-34
35-44
45-54
55-64

这些字段表示对应年龄段的用户数量。

`keyword_properties`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`core_keyword`	string/null	同义词聚类中的核心。无法识别同义词时为 `null`。
`synonym_clustering_algorithm`	string/null	同义词识别算法：`keyword_metrics` 或 `text_processing`。
`keyword_difficulty`	integer	难度，取值范围为 `0` 到 `100`，数值越高通常越难自然搜索前 10 名。
`detected_language`	string/null	系统识别出的语言。
`is_another_language`	boolean	识别出的语言是否与请求设置的语言不同。

`serp_info`

当未启用 include_serp_info，或数据库中没有该的 SERP 数据时，字段值为 null。

字段	类型	说明
`se_type`	string	搜索引擎类型。
`check_url`	string	可直接访问的搜索结果检查地址。
`serp_item_types`	array	SERP 中发现的结果类型。
`se_results_count`	string	该的搜索结果数量。
`last_updated_time`	string	SERP 数据更新时间。
`previous_updated_time`	string	上一次 SERP 数据更新时间。

支持识别的 SERP 类型：

answer_box、app、carousel、multi_carousel、featured_snippet、images、jobs、knowledge_graph、local_pack、map、organic、paid、people_also_ask、related_searches、shopping、top_stories、video、events、recipes、popular_products、podcasts、questions_and_answers、short_videos、discussions_and_forums、courses、ai_overview 等。

返回详细 SERP素数据的类型为：

organic
paid
featured_snippet
local_pack

`avg_backlinks_info`

该对象描述自然搜索前 10 个结果的平均外链和排名指标。

字段	类型	说明
`se_type`	string	搜索引擎类型。
`backlinks`	float	平均反向链接数量。
`dofollow`	float	平均 Dofollow 链接数量。
`referring_pages`	float	平均引荐页面数量。
`referring_domains`	float	平均引荐域名数量。
`referring_main_domains`	float	平均引荐主域名数量。
`rank`	float	平均页面排名。
`main_domain_rank`	float	平均主域名排名。
`last_updated_time`	string	外链数据更新时间。

`search_intent_info`

字段	类型	说明
`se_type`	string	搜索引擎类型，通常为 `google`。
`main_intent`	string	主要搜索意图。
`foreign_intent`	array/null	搜索意图。
`last_updated_time`	string	搜索意图数据更新时间。

main_intent 和 foreign_intent 支持：

informational：信息型
navigational：导航型
commercial：商业调研型
transactional：交易型

归一化数据

keyword_info_normalized_with_bing 和 keyword_info_normalized_with_clickstream 结构相似，均：

字段	类型	说明
`last_updated_time`	string	数据集更新时间。
`search_volume`	integer	归一化后的当前搜索量。
`is_normalized`	boolean	是否已完成归一化。
`monthly_searches`	array	月度归一化搜索量。

域名 SERP素

first_domain_serp_element 和 second_domain_serp_element 分别表示两个目标域名在当前下发现的 SERP素。对象中的 se_type 表示搜索引擎类型，结构取决于类型。

通用 SERP 字段

自然结果、付费结果、本地结果和精选摘要通常以下字段：

字段	类型	说明
`type`	string	SERP素类型。
`rank_group`	integer	同类型中的排名。
`rank_absolute`	integer	在 SERP素中的绝对排名。
`position`	string	素在页面中的位置：`left` 或 `right`。
`xpath`	string	素在页面中的 XPath。
`domain`	string	SERP 中展示的域名或子域名。
`title`	string	搜索结果标题。
`url`	string	结果 URL。
`breadcrumb`	string	面屑路径。
`main_domain`	string	主域名。
`relative_url`	string	不协议和域名的相对 URL。
`etv`	float	预估月流量，根据点击率和搜索量估算。
`estimated_paid_traffic_cost`	float	将预估自然流量通过付费广告获取的预估月成本。
`clickstream_etv`	integer/null	基于点击流数据估算的流量。启用 `include_clickstream_data` 后返回。
`rank_changes`	object	自上次更新以来的排名变化。
`backlinks_info`	object/null	当前排名页面的外链信息。
`rank_info`	object	当前页面和主域名的排名信息。

自然结果 `organic`

type 固定为 organic，此外还可能：

字段	类型	说明
`website_name`	string	网站名称。
`is_image`	boolean	是否图片。
`is_video`	boolean	是否视频。
`is_featured_snippet`	boolean	是否为精选摘要。
`is_malicious`	boolean	是否被标记为恶意结果。
`description`	string	结果描述。
`pre_snippet`	string	描述前附加的信息。
`extended_snippet`	string/null	描述后附加的信息。
`amp_version`	boolean	是否存在 AMP 版本。
`rating`	object/null	结果评分。
`highlighted`	array	描述中加粗显示的词语。
`links`	array/null	站点链接。
`about_this_result`	object/null	“此结果”面板信息。

付费结果 `paid`

type 固定为 paid，此外还可能：

字段	类型	说明
`domain`	string	广告结果中的域名。
`description`	string	广告描述。
`breadcrumb`	string	广告面屑。
`url`	string	广告目标 URL。
`highlighted`	array	描述中加粗显示的词语。
`extra`	array	广告附加信息。
`links`	array/null	广告站点链接。

extra 常见字段：

字段	类型	说明
`ad_aclk`	string	广告标识符。
`description_rows`	array/null	扩展描述。

本地结果 `local_pack`

type 固定为 local_pack，此外还可能：

字段	类型	说明
`description`	string	本地结果描述。
`phone`	string	电话号码。
`is_paid`	boolean	是否为广告结果。
`rating`	array	本地结果评分。

精选摘要 `featured_snippet`

type 固定为 featured_snippet，此外还可能：

字段	类型	说明
`featured_title`	string	精选摘要来源页面标题。
`description`	string	精选摘要。
`table`	object/null	精选摘要中的表格数据。

table 字段：

字段	类型	说明
`table_header`	array	表头。
`table_content`	array	表格，每个表示一行。

评分字段

rating 对象可能：

字段	类型	说明
`rating_type`	string	评分类型：`Max5`、`Percents` 或 `CustomMax`。
`value`	integer	评分值。
`votes_count`	integer	评价数量。
`rating_max`	integer	当前评分类型的最大值。

排名变化字段

rank_changes 对象当前 SERP素与上次更新相比的排名变化：

字段	类型	说明
`previous_rank_absolute`	integer/null	上一次的绝对排名。新出现的为 `null`。
`is_new`	boolean	是否为新出现的 SERP素。
`is_up`	boolean	排名是否上升。
`is_down`	boolean	排名是否下降。

预估流量指标

etv：预估自然月流量，通常点击率乘以搜索量计算。
estimated_paid_traffic_cost：将对应自然流量通过 Google 搜索广告获取时的预估月成本，通常自然流量乘以付费 CPC 计算。
clickstream_etv：基于点击流搜索量和点击率估算的流量。只有启用 include_clickstream_data 时才会返回。

外链和排名信息

`backlinks_info`

字段	类型	说明
`referring_domains`	integer	引荐域名数量，子域名会分别计数。
`referring_main_domains`	integer	引荐主域名数量。
`referring_pages`	integer	指向当前页面的页面数量。
`dofollow`	integer	Dofollow 链接数量。
`backlinks`	integer	反向链接总数 Dofollow 和 Nofollow 链接。
`time_update`	string	外链数据更新时间。

`rank_info`

字段	类型	说明
`page_rank`	integer	页面排名指标，根据链接数据库中的节点排名方法计算。
`main_domain_rank`	integer	主域名排名指标，根据链接数据库中的节点排名方法计算。

错误处理

建议根据顶层和任务级 status_code 分别处理请求错误和任务错误：

20000：请求成功
非 20000：请求或任务处理失败，应结合 status_message 定位原因

完整错误码请参考错误码文档。

实用场景

发现竞品排名：对比两个域名的交集，识别双方都覆盖但自身页面表现不足的主题，指导补齐和页面优化。
筛选高价值机会：按 search_volume、cpc、keyword_difficulty 和 etv 过滤，优高搜索量、高商业价值且可实现的 SEO 主题。
比较两个域名的 SERP 表现：同时分析 first_domain_serp_element 和 second_domain_serp_element，定位排名差距、页面类型差异及对应 URL。
评估自然流量的广告替代成本：使用 etv 和 estimated_paid_traffic_cost 估算自然排名带来的流量价值，为 SEO 与 SEM 预算分提供依据。
分析 SERP 特征覆盖：筛选 organic、paid、local_pack 和 featured_snippet 结果，判断竞品在不同 SERP 展示位上的占位策略。

Google 域名交集（实时接口） ​

请求信息 ​

计费说明 ​

请求参数 ​

任务级参数 ​

地理位置和语言 ​

intersections 参数说明 ​

filters 过滤器 ​

order_by 排序 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

响应结构 ​

顶层响应字段 ​

tasks 任务字段 ​

result 结果字段 ​

items 结果 ​

基础字段 ​

keyword_data ​

keyword_info ​

clickstream_keyword_info ​

keyword_properties ​

serp_info ​

avg_backlinks_info ​

search_intent_info ​

归一化数据 ​

域名 SERP素 ​

通用 SERP 字段 ​

自然结果 organic ​

付费结果 paid ​

Google 域名交集（实时接口）

请求信息

计费说明

请求参数

任务级参数

地理位置和语言

`intersections` 参数说明

`filters` 过滤器

`order_by` 排序

请求示例

curl

Python

TypeScript

响应结构

顶层响应字段

`tasks` 任务字段

`result` 结果字段

`items` 结果

基础字段

`keyword_data`

`keyword_info`

`clickstream_keyword_info`

`keyword_properties`

`serp_info`

`avg_backlinks_info`

`search_intent_info`

归一化数据

域名 SERP素

通用 SERP 字段

自然结果 `organic`

付费结果 `paid`