提供一个查询词和搜索地区，通过 DataForSEO 查询公开的 Google Ads 透明度数据。任务完成后，可获得广告主账号、账号组或域名匹配记录及可用详情。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
提供一个查询词和搜索地区，通过 DataForSEO 查询公开的 Google Ads 透明度数据。任务完成后，可获得广告主账号、账号组或域名匹配记录及可用详情。
按查询词和搜索地区获取完成后的广告主查询结果。记录可能是单个账号、名称相近的账号组，或域名。可用详情包括名称、广告主 ID、账号所属国家、Google 认证状态及广告数量估值；仅有域名的记录可能没有账号详情。 让 Agent 按记录类型分别整理这些信息，便于你判断哪些匹配结果值得继续了解。
查找[电动汽车]在[美国]相关的 Google Ads 公开广告主资料，并整理找到的名称、网站和广告数量估算。
匹配结果不能直接确认某个企业身份，也不能证明广告主正在对该查询词竞价。搜索地区与账号所属国家可能不同。覆盖范围和数据时效有限，广告数量估值不能证明完整的实时广告创意库存或投放效果。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
查询条件request | object | 必填 | 必填对象，包含查询词和支持的搜索地区代码。本次查询须同时提供这两项。
|
查询词request.keyword | string | 必填 | 必填查询文本，长度 1–256 字符，例如 apple。匹配不能保证企业身份完全一致，也不代表广告主对这些词竞价。字面加号或百分号须按供应商要求使用 %2B 或 %25 编码，提交后的字符串仍不超过 256 字符。
|
搜索地区代码request.location_code | integer | 必填 | 必填且须为供应商支持的整数地区代码，范围 1–100000000。美国代码 2840 仅作示例，不是默认值；数值在范围内并不代表该代码一定受支持。搜索地区也不表示全部返回账号都属于该地区。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"location_code",
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"location_code": {
"type": "integer",
"maximum": 100000000,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
记录类型及可用详情见 DataForSEO 的 Google Ads 广告主结果说明。结果位置描述记录在返回查询结果中的排列，不代表投放效果。
结果可能包含公司名称或网站、Google 是否显示广告主已认证、资料中列出的国家或地区，以及可查到的广告数量估算。有些结果可能只显示网站。
查找[电动汽车]在[美国]相关的 Google Ads 公开广告主资料，并整理找到的名称、网站和广告数量估算。
搜索结果中出现某个名称，不代表该广告主一定销售相关产品，也不能证明它专门针对这个词投放广告。你选择的国家或地区用于确定搜索范围，资料中列出的广告主所在地可能不同。
把匹配结果作为待了解的记录。它可能是名称相近的账号组、单个账号或域名，不能直接确认你要找的企业身份。查询也不能证明广告主正在对这些词竞价。
地区代码确定查询的搜索地区，账号报告的所属国家可能不同。分别保留搜索地区与账号国家；没有国家信息时，不自行补全。
认证状态表示 Google Ads 的认证情况，不代表推荐或确认该记录就是你要找的企业。广告数量是供应商覆盖的 Google 广告平台上的近似数量，不表示广告支出或投放效果，也不保证包含全部当前投放的广告创意。
返回记录数包含不同类型的查询条目；一个账号组可能包含多个账号，因此记录、账号与企业是不同的计数单位。同类型位置只在相同结果类型内排序，绝对位置包含全部结果类型，均不是质量或投放效果评分。0、false 与缺失值分别保留。
当前工具会处理提交与完成检查，成功完成后才提供查询结果；提交本身不保证成功。结果收到时间不代表每个账号或广告的更新时间。可用字段及覆盖范围可能变化，缺少详情也不能证明账号或广告不存在。