Google Ads 网站关键词实时查询

/keywords_data_google_ads_keywords_for_site_live

注意：Google Ads Keywords Data API 基于新版 Google Ads API，已取代旧版 Google AdWords API。若当前使用 DataForSEO Google AdWords API，需要升级至 DataForSEO Google Ads API。该接口返回与指定域名相关的关键词列表，包含出价、上个月搜索量、过去一年的搜索量趋势（用于评估变化）及竞争程度。

最近 7 天完成的调用: 0

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

文档（英文）

;;;;----=====++++++++=====----;;;::::····........                   .............···········............                             ......····:::::;;;;--------------;;;;;:::::······..................
;;;----===++++++++++++++====---;;;;:::·····.........             .................·····..............                                 ......····::::;;;;;--------------;;;;;:::::·······................
;;;---===++++++*****++++++===----;;;::::·····...................................·····.............                                     ......····::::;;;;;-------------;;;;;;::::::········.............
;;;---===++++*********+++++===---;;;;::::·····.............................···········...........                                       ......····::::;;;;;------------;;;;;;:::::::····················
;;;---===++++**********++++====---;;;;::::·······....................··················.........                                         ......····::::;;;;;;;------;;;;;;;;;:::::::····················
:;;;---===+++++*******+++++====----;;;:::::··········........···························........                                          ......····:::::;;;;;;;;;;;;;;;;;;:::::::::·················:::
::;;---====++++++++++++++++====---;;;;;:::::·····························::::::··········.......                                           ......·····::::::;;;;;;;;;;;;::::::::::················::::::
::;;;----====++++++++++++=====----;;;;:::::::····················:::::::::::::::::::······......                                            ......······:::::::::::::::::::::::··················:::::::
:::;;;;----=================----;;;;;;:::::::···············::::::::::::::::::::::::::·····......                                            ......·······::::::::::::::::·······················::::::;
·::::;;;-----===========------;;;;;;::::::::·············::::::::::;;;;;;;;;;;;;;;::::::·····.....                                           .......·············································::::::;
··::::;;;;;----------------;;;;;;::::::::···············:::::::::;;;;;;;;;;;;;;;;;;;;::::·····.....                                           ........························...........·········:::::;
···:::::;;;;;;;-----;;;;;;;;;::::::::···················:::::::;;;;;;;;---------;;;;;;::::·····.....                                          .........···············.......................······::::;
····::::::;;;;;;;;;;;;;;::::::::························:::::::;;;;;;--------------;;;;;::::····.....                                        .............·····................................·····::::
·····:::::::::::::::::::::::··········..........·········::::::;;;;;;---------------;;;;;:::·····.....                                     .....................................................·····:::
······:::::::::::::::::·········....................·······:::::;;;;;----------------;;;;::::····......                                  ..................................               ........·····:
······::::::::::::··········..........................······:::::;;;;;---------------;;;;;::::····......                              ..............·····...............                    ........····
······::::::::··········............          ..........······::::;;;;;--------------;;;;;::::·····.......                        ............·············............                       .......···
·····:::::::··········.........                   ........·····:::::;;;;;;---------;;;;;;:::::·····........                   ...........····················.........                          ......··
·:::::::::::········........                         .......·····:::::;;;;;;;;;;;;;;;;;;::::::·····...........          ............···········:::::··········.........                          .......
::::::::::::·······........                            .......·····::::::;;;;;;;;;;;;;::::::·······.............................········:::::::::::::::::·······.......                           ......
:::::::::::::······.......                               .......······::::::::::::::::::::········...........................·······:::::::;;;;;;;;;;:::::::·····.......                           .....
;;;;;;;;::::::·····......                                  .......·······::::::::::::::·········..........................······::::::;;;;;;;;;;;;;;;;;;;:::::·····......                          .....
---;;;;;;;;::::·····.....                                   ........·························...........................······:::::;;;;;--------------;;;;;:::::····.......                        .....
--------;;;;::::····......                                    .........·················...............................······::::;;;;------=========-----;;;;::::·····.......                      .....
=====-----;;;;:::····.....                                     ....................................          ..........·····::::;;;;----===============----;;;;::::····........                  .......
+=======----;;;:::····.....                                      ............................                  ........····::::;;;----=====++++++++++====----;;;::::·····.........            ..........
++++++====---;;;:::····.....                                      .....................                         .......····::::;;;---====++++++++++++++====---;;;;::::·····.............................
**++++++===---;;;:::···......                                     ................                                ......····:::;;;---===+++++++***++++++====---;;;;::::······.........................··
*****++++===---;;;:::···......                                    .............                                    .....····:::;;;---====+++++*****++++++====---;;;;::::········.................·······
******++++===--;;;:::····......                                 ............                                        .....····:::;;;---===+++++++**+++++++====----;;;;:::::······························
******++++===---;;;:::····......                            ................                                         .....···::::;;----===++++++++++++++=====----;;;;::::::························:::::
******++++===---;;;:::·····.......                     ......................                                         .....···:::;;;----=====+++++++++======----;;;;;:::::::·················:::::::::::
****+++++===----;;;::::····..........            .............................                                         ....····:::;;;;----================-----;;;;;:::::::::···········::::::::::::;;;;
+++++++====----;;;::::······...................................................                                        .....····::::;;;------=========-------;;;;;;:::::::::········:::::::::::;;;;;;;;;
+++=======----;;;:::::······...........................················.........                                        .....····::::;;;;;---------------;;;;;;;:::::::::··········::::::::::;;;;;;;;;--
======------;;;;:::::······.......................························.......                                       .....·····:::::;;;;;;;;;-;;;;;;;;;;;::::::::················::::::::;;;;;;;-----
--------;;;;;;:::::······......................···········::::::::::········.......                                     ......·····::::::;;;;;;;;;;;;;;::::::::······················:::::::;;;;;-------
;;;;;;;;;;::::::·······......................········:::::::::::::::::::······......                                    ......······::::::::::::::::::::::····························::::::;;;;;-------
;;;;;:::::::········........................·······:::::::::;;;;;;;:::::::······......                                 .......·······::::::::::::::::···········................········:::::;;;;;------
::::::::········............................······:::::::;;;;;;;;;;;;;;:::::·····.......                              .......·········:::::::::::··········........................······:::::;;;;------
::·········............           ..........······:::::;;;;;;;;;;;;;;;;;;:::::·····.......                          ........··········::::::···········..............    ............······::::;;;;;----
·······..........                    ........·····:::::;;;;;;;------;;;;;;;:::::·····.......                    ..........··········::::::··········...........                ........·····:::::;;;;;--
···..........                          .......····:::::;;;;;;---------;;;;;;:::::·····..........           ............·········::::::::::·········.........                      .......·····:::::;;;;;
..........                              ......·····::::;;;;;;----------;;;;;;:::::······...........................········::::::::::::::::·······........                          .......·····::::::;;
.......                                   ......····::::;;;;;;;-------;;;;;;;::::::·······....................·········:::::::::::::::::::::······.......                             .......·····::::::
......                                     ......····:::::;;;;;;;;;;;;;;;;;;;:::::::·········............·········::::::::;;;;;;;;;;;;;::::::·····......                                .......······:::
.....                                       ......····::::::;;;;;;;;;;;;;;;;::::::::··························:::::::;;;;;;;;;;;;;;;;;;;;:::::····......                                  .......·······
....                                          .....·····::::::;;;;;;;;;;;;:::::::::·······················:::::::;;;;;;---------------;;;;;::::····......                                  .........····

通过你的 Agent 使用

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

输入参数

target必填: 域名或页面，必填。提供目标网站域名或目标页面 URL；需要整个网站的关键词时请使用 target_type 参数。
target_type选填: 搜索整个网站或单页的关键词，可选。site 返回整个网站的关键词，page 返回指定网页的关键词。默认 page。
location_name选填: 搜索引擎地区的完整名称。可选字段。不指定地区则返回全球结果，即所有可用地区的数据；使用此字段后无需指定 location_code 或 location_coordinate；可单独请求下列地址，获取搜索引擎可用地区及其 location_name ： https://api.dataforseo.com/v3/keywords_data/google_ads/locations；例如： London,England,United Kingdom
location_code选填: 搜索引擎地区代码。可选字段。不指定地区则返回全球结果，即所有可用地区的数据；使用此字段后无需指定 location_name 或 location_coordinate ;；可单独请求下列地址，获取搜索引擎可用地区及其 location_code ： https://api.dataforseo.com/v3/keywords_data/google_ads/locations；例如： 2840
location_coordinate选填: 地区 GPS 坐标。可选字段。不指定地区则返回全球结果，即所有可用地区的数据；使用此字段后无需指定 location_name 或 location_code ; location_coordinate 参数应使用以下格式指定： "latitude,longitude" 格式；数据将针对所指定坐标所属的国家提供。 ;；例如： 52.6178549,-155.352142
language_name选填: 搜索引擎语言的完整名称。可选字段。可单独请求下列地址，获取搜索引擎可用语言及其 language_name ： https://api.dataforseo.com/v3/keywords_data/google_ads/languages；例如： English
language_code选填: 搜索引擎语言代码。可选字段。可单独请求下列地址，获取搜索引擎可用语言及其 language_code ： https://api.dataforseo.com/v3/keywords_data/google_ads/languages；例如： en
search_partners选填: 包含 Google 搜索合作伙伴，可选。true 时返回 Google 及托管 Google 搜索的合作网站的自有、运营和联合分发网络数据。默认 false，仅返回 Google 搜索网站数据。
date_from选填: 时间范围起始日期，可选，日期格式为 "yyyy-mm-dd"。最早可回溯当前日期之前 4 年；默认返回最近 12 个月数据。不得晚于 date_to 或昨天。状态接口的 actual_data 为 false 时，date_from 可设为上上个月或更早；actual_data 为 true 时，可设为上个月或更早。
date_to选填: 时间范围结束日期，可选，不得晚于昨天，未指定时默认昨天。日期格式为 "yyyy-mm-dd"，例如 "2022-11-30"。
include_adult_keywords选填: 包含成人内容相关关键词，可选。true 时响应包含成人关键词，默认 false。由于 Google Ads 限制，API 仍可能不返回这些关键词的数据。
sort_by选填: 结果排序参数，可选。按 relevance、search_volume、competition_index、low_top_of_page_bid 或 high_top_of_page_bid 降序排列，默认 relevance。

输入示例

{
  "location_code": 2840,
  "target": "dataforseo.com"
}

输出

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