DataForSEODataForSEO

Google 页面关键词实时交集

/dataforseo_labs_google_page_intersection_live

返回指定页面在同一搜索结果中获得排名的关键词,包含每个交集关键词的搜索量、竞争程度及每次点击费用,并提供这些页面对应的搜索结果元素、估算流量及广告流量成本。支持 organic、paid、local pack、featured snippet 和 ai_overview_reference 结果。详情:'https://docs.dataforseo.com/v3/dataforseo_labs/google/page_intersection/live/?bash'

最近 7 天完成的调用
0

统计不包含取消的调用。执行时间仅统计成功调用。

通过你的 Agent 使用

请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 DataForSEO 的 /dataforseo_labs_google_page_intersection_live 接口。

输入参数

pages选填
目标页面 URL,必填。此对象最多设置 20 个页面,须使用包含 http:// 或 https:// 的绝对 URL。例如:"pages": {"1":"https://www.apple.com/mac/*","2":"https://dataforseo.com/*","3":"https://support.microsoft.com/"}。仅指定一个页面时,仅返回该页结果。可用通配符指定搜索模式:"example.com" 搜索精确 URL;"example.com/eng/" 搜索 example.com 页面及所有以 '/eng/' 开头的相关 URL,例如 "example.com/eng/index.html"、"example.com/eng/help/"。通配符应放在 URL 末尾斜杠 '/' 后,不能直接放在域名后;请使用 https://dataforseo.com/ 而非 https://dataforseo.com。交集关键词数超过 10 million(一千万)时,此接口不返回结果。
exclude_pages选填
要排除的页面 URL,可选。此数组最多设置 10 个页面。使用后,结果包含 pages 对象中 URL 有排名、但 exclude_pages 数组中 URL 无排名的关键词。指定此字段时,默认基于 pages 中任意 URL 有排名的关键词,而不考虑它们之间的交集;可将 intersection_mode 设为 intersect,仅返回同一搜索结果页中所有 pages URL 均有排名且 exclude_pages URL 无排名的关键词。使用通配符 '*' 指定搜索模式。例如:"exclude_pages":["https://www.apple.com/iphone/*","https://dataforseo.com/apis/*","https://www.microsoft.com/en-us/industry/services/"]。
location_name选填
地区完整名称。未指定 location_code 时必填,location_name 和 location_code 必须提供一项。可单独请求 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 获取可用地区及其 location_name。例如:United Kingdom。
location_code选填
地区代码。未指定 location_name 时必填,location_name 和 location_code 必须提供一项。可单独请求 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 获取可用地区及其 location_code。例如:2840。
language_name选填
语言完整名称。未指定 language_code 时必填,language_name 和 language_code 必须提供一项。可单独请求 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 获取可用语言及其 language_name。例如:English。
language_code选填
语言代码。未指定 language_name 时必填,language_name 和 language_code 必须提供一项。可单独请求 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 获取可用语言及其 language_code。例如:en。
item_types选填
搜索结果类型,可选,指定响应包含的类型。可用值:["organic", "paid", "featured_snippet", "local_pack", "ai_overview_reference"]。默认:["organic", "paid"]。
limit必填
返回关键词数上限。可选字段。默认值: 100最大值: 1000
offset选填
返回关键词的 items 数组偏移量,可选,默认 0。指定 10 时跳过结果数组前十个关键词,返回后续关键词。
include_subdomains选填
是否在搜索中包含子域名,可选。设为 false 时忽略子域名,默认 true。
intersection_mode选填
是否对关键词取交集,可选,用于合并指定 URL 的结果或取交集。union:基于 pages 中任意 URL 有排名的全部关键词;intersect:基于同一搜索结果页中所有 pages URL 均有排名的关键词。仅指定 pages 数组时默认 intersect;同时指定 exclude_pages 时默认 union。
include_serp_info选填
包含各关键词的搜索结果页数据,可选。设为 true 时,为响应中每个关键词返回 serp_info 数组,包含搜索结果数量、相关 URL 和搜索结果页特性。默认 false。
ignore_synonyms选填
忽略高度相似的关键词,可选。设为 true 时仅返回核心关键词,排除所有高度相似的关键词。默认 false。
filters选填
结果筛选参数数组,可选。可同时添加多个条件,最多 8 个,条件间使用 and、or。支持的运算符:regex、not_regex、>=、=、in、not_in、ilike、not_ilike、like、not_like、match、not_match。% 可与 like、not_like、ilike、not_ilike 配合,匹配零个或多个任意字符。按 intersection_result 数组字段筛选时须指定对应页编号。例如按首个 URL 排名筛选:[intersection_result.1.rank_absolute,"=",1];仅获取第三个 URL 的自然搜索结果:[intersection_result.3.type,"=","organic"]。其他示例:["keyword_data.keyword_info.search_volume","in",[100,1000]];[["intersection_result.1.etv",">",0],"and",["intersection_result.1.description","like","%goat%"]];[["keyword_data.keyword_info.search_volume",">",100],"and",[["intersection_result.2.description","like","%goat%"],"or",["intersection_result.2.type","=","organic"]]]。详情参见 Dataforseo Labs 筛选说明或帮助中心指南。
order_by选填
结果排序规则。可选字段。可使用 filters 数组中相同的字段值对结果排序。可用排序类型:asc :按升序排列结果;desc :按降序排列结果;请使用逗号指定排序参数。例如:["keyword_data.keyword_info.competition,desc"]默认规则:["keyword_data.keyword_info.search_volume,desc"]注意:单次请求最多设置三条排序规则。请使用逗号分隔多个排序规则。例如:["intersection_result.1.rank_group,asc","intersection_result.2.rank_absolute,asc"]
include_clickstream_data必填
仅使用 Basic 费率;付费的点击流升级已禁用。

输入示例

{
  "pages": {
    "1": "https://forbes.com",
    "2": "https://cnn.com/*"
  },
  "language_name": "English",
  "location_code": 2840,
  "include_serp_info": true,
  "limit": 3,
  "include_clickstream_data": false
}

输出

原生任务结果封装;在支持时包含条目、聚合结果和分页信息。