获取 Google Ads Advertisers 高级结果（按任务 ID）

接口说明

用于根据任务 ID 获取 Google Ads Advertisers 的高级结果。

请求方式： GET请求地址：

https://api.seermartech.cn/v3/serp/google/ads_advertisers/task_get/advanced/$id

说明：
账户在创建任务时扣费；
任务结果在生成后的 30 天 可重复获取；
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

路径参数

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。该 ID 可在任务创建后 30 天用于随时获取结果。

Sandbox 调试

可使用以下沙箱地址查看该端点支持的所有结果结构与字段，返回为模拟数据，不会产生费用：

https://sandbox.本平台.com/v3/serp/google/ads_advertisers/task_get/advanced/00000000-0000-0000-0000-000000000000

Sandbox 响应会 Google Ads Advertisers Advanced 端点下所有可用及示例字段值。

返回结果结构

接口返回 JSON 数据，顶层 tasks 数组，每个任务对象中对应结果。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用状态码。建议对异常状态建立完整处理机制。
`status_message`	string	通用状态信息。
`time`	string	接口执行耗时，单位秒。
`cost`	float	本次请求总成本，单位 USD。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	返回错误的任务数量。
`tasks`	array	任务结果数组。

tasks[] 字段

字段	类型	说明
`id`	string	任务 ID，UUID 格式。
`status_code`	integer	任务状态码，范围通常为 `10000-60000`。
`status_message`	string	任务状态说明。
`time`	string	任务执行耗时，单位秒。
`cost`	float	单个任务成本，单位 USD。
`result_count`	integer	`result` 数组中的结果数量。
`path`	array	URL 路径。
`data`	object	与创建任务时传的参数一致。
`result`	array	获取结果数组。

result[] 字段

字段	类型	说明
`keyword`	string	POST 提交时的。返回时会解码 `%##`， `+` 会被解码为空格。
`type`	string	POST 请求中的搜索引擎类型。
`se_domain`	string	POST 请求中的搜索引擎域名。
`location_code`	integer	POST 请求中的地区代码。
`language_code`	string	POST 请求中的语言代码。
`check_url`	string	搜索结果直达链接，可用于校验结果准确性。
`datetime`	string	结果抓取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`spell`	object	搜索引擎自动纠错信息；若未发生纠错则为 `null`。
`refinement_chips`	object	搜索细化建议。
`item_types`	array	当前 SERP 中出现的结果类型。可能值：`ads_muti_account_advertiser`、`ads_advertiser`、`ads_domain`。
`se_results_count`	integer	SERP 总结果数。
`items_count`	integer	`items` 数组中的数量。
`items`	array	SERP 中识别到的结果。

字段	类型	说明
`type`	string	素类型，固定为 `refinement_chips`。
`xpath`	string	素的 XPath。
`items`	array	细化项列表。

字段	类型	说明
`type`	string	素类型，固定为 `refinement_chips_element`。
`title`	string	细化项标题。
`url`	string	带细化参数的搜索 URL。
`domain`	string	该项对应域名。
`options`	array	更多细化选项。

字段	类型	说明
`type`	string	素类型，固定为 `refinement_chips_option`。
`title`	string	选项标题。
`url`	string	带细化参数的搜索 URL。
`domain`	string	该选项对应域名。

items[] 结果类型说明

1) ads_multi_account_advertiser

表示在 Google Ads 中存在多个相似标题的广告主账户。

字段	类型	说明
`type`	string	固定为 `ads_multi_account_advertiser`。
`rank_group`	integer	同类型的组排名。不同类型不计该排名。
`rank_absolute`	integer	在整个 SERP 中的绝对排名。
`title`	string	广告主名称。
`location`	string	广告主地区。
`approx_ads_count`	integer	该广告主在所有可用 Google Ads 平台上的广告数量估算值。
`advertisers`	array	广告账户列表。

advertisers[] 字段

字段	类型	说明
`type`	string	素类型，可能为 `advertiser`。
`advertiser_id`	string	广告主账户唯一 ID，可用于通过 `/v3/serp/google/ads_search/task_post/` 获取广告活动数据。
`location`	string	广告账户对应的国家/地区代码。
`verified`	boolean	是否为已验证广告账户。`true` 表示已通过 Google Ads 验证。
`approx_ads_count`	integer	该账户在所有可用 Google Ads 平台上的广告数量估算值。

2) ads_advertiser

表示单个 Google Ads 广告主账户。

字段	类型	说明
`type`	string	固定为 `ads_advertiser`。
`rank_group`	integer	同类型的组排名。
`rank_absolute`	integer	在整个 SERP 中的绝对排名。
`title`	string	广告主名称。
`location`	string	广告主地区。
`verified`	boolean	是否为已验证广告主。
`approx_ads_count`	integer	该广告主在所有可用 Google Ads 平台上的广告数量估算值。

3) ads_domain

表示通过域名识别出的 Google Ads 广告主。

字段	类型	说明
`type`	string	固定为 `ads_domain`。
`rank_group`	integer	同类型的组排名。
`rank_absolute`	integer	在整个 SERP 中的绝对排名。
`domain`	string	域名，例如：`example.com`。

调用示例

cURL

bash

id="02261816-2027-0066-0000-c27d02864073"

curl --location --request GET "https://api.seermartech.cn/v3/serp/google/ads_advertisers/task_get/advanced/${id}" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

python

import requests

task_id = "02231256-2604-0066-2000-57133b8fc54e"
url = f"https://api.seermartech.cn/v3/serp/google/ads_advertisers/task_get/advanced/{task_id}"

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

response = requests.get(url, headers=headers)
print(response.json)

TypeScript

typescript

import axios from "axios";

const taskId = "02231256-2604-0066-2000-57133b8fc54e";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/serp/google/ads_advertisers/task_get/advanced/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 // 输出结果数据
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

结果获取建议

通常推荐以下流程：

通过任务提交接口创建任务；
再通过 /v3/serp/google/ads_advertisers/tasks_ready 获取已完成任务列表；
使用返回的任务 ID 调用 /v3/serp/google/ads_advertisers/task_get/advanced/$id 拉取高级结果。

这样可以更高效地批量处理异步任务结果。

响应示例

json

{
 "version": "0.1.20241101",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0751 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "task_get",
 "se": "google",
 "se_type": "ads_advertisers",
 "location_code": 2840,
 "keyword": "apple",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 0,
 "items_count": 17,
 "items": [
 {
 },
 {
 "type": "ads_multi_account_advertiser",
 "rank_group": 2,
 "rank_absolute": 2,
 "title": "Apple",
 "location": "US",
 "approx_ads_count": 702,
 "advertisers": []
 },
 {
 "type": "ads_advertiser",
 "rank_group": 1,
 "rank_absolute": 3,
 "title": "AppleAire:US",
 "advertiser_id": "AR17003630320609656833",
 "location": "US",
 "verified": true,
 "approx_ads_count": 66
 },
 {
 "type": "ads_advertiser",
 "rank_group": 2,
 "rank_absolute": 4,
 "title": "Apple Inc:US",
 "advertiser_id": "AR04280480096432685057",
 "location": "US",
 "verified": true,
 "approx_ads_count": 58
 },
 {
 "type": "ads_advertiser",
 "rank_group": 3,
 "rank_absolute": 5,
 "title": "Apple Auto:US",
 "advertiser_id": "AR12151332228441309185",
 "location": "US",
 "verified": true,
 "approx_ads_count": 18
 },
 {
 "type": "ads_advertiser",
 "rank_group": 4,
 "rank_absolute": 6,
 "title": "Apple Wood:US",
 "advertiser_id": "AR06010505619184812033",
 "location": "US",
 "verified": true,
 "approx_ads_count": 2
 },
 {
 "type": "ads_advertiser",
 "rank_group": 5,
 "rank_absolute": 7,
 "title": "Apple:AU",
 "advertiser_id": "AR03460445289142288385",
 "location": "AU",
 "verified": false,
 "approx_ads_count": 1
 },
 {
 "type": "ads_domain",
 "rank_group": 1,
 "rank_absolute": 8,
 "domain": "apple.com"
 },
 {
 "type": "ads_domain",
 "rank_group": 2,
 "rank_absolute": 9,
 "domain": "snapple.com"
 },
 {
 "type": "ads_domain",
 "rank_group": 3,
 "rank_absolute": 10,
 "domain": "applern.com"
 },
 {
 "type": "ads_domain",
 "rank_group": 4,
 "rank_absolute": 11,
 "domain": "kappler.com"
 },
 {
 "type": "ads_domain",
 "rank_group": 5,
 "rank_absolute": 12,
 "domain": "apple.com.cn"
 },
 {
 "type": "ads_domain",
 "rank_group": 6,
 "rank_absolute": 13,
 "domain": "applefcu.org"
 },
 {
 "type": "ads_domain",
 "rank_group": 7,
 "rank_absolute": 14,
 "domain": "applecart.co"
 },
 {
 "type": "ads_domain",
 "rank_group": 8,
 "rank_absolute": 15,
 "domain": "apple4you.hu"
 },
 {
 "type": "ads_domain",
 "rank_group": 9,
 "rank_absolute": 16,
 "domain": "applegate.com"
 },
 {
 "type": "ads_domain",
 "rank_group": 10,
 "rank_absolute": 17,
 "domain": "applerock.com"
 }
 ]
 }
 ]
 }
 ]
}

状态码说明

字段	说明
`status_code`	顶层或任务级状态码。建议根据返回码统一处理成功、重试、参数错误、权限错误及额限制等。
`status_message`	与状态码对应的说明信息。

建议结合参考文档中的错误码说明，针对 4xxxx 和 5xxxx 状态建立重试、告警与底机制。

实用场景

识别品牌投放主体：按查看 Google Ads 中出现的广告主账户、账户和域名，帮助品牌监测谁在竞争同类流量。
分析竞品广告规模：基于 approx_ads_count 评估广告主或账户的大致投放活跃度，为竞品投放强度分析提供依据。
追踪多账户投放：通过 ads_multi_account_advertiser 与 advertisers 识别同一品牌下的多账户结构，集团品牌或代理商投放研究。
提取广告主域名池：从 ads_domain 结果中收集域名，构建竞品站点名单，用于后续 SEO、投放与市场报分析。
广告搜索分析：使用 advertiser_id 进一步衔接 /v3/serp/google/ads_search/task_post/，查看特定广告主的广告活动与创意分布。

获取 Google Ads Advertisers 高级结果（按任务 ID）

接口说明

路径参数

Sandbox 调试

返回结果结构

顶层字段

tasks[] 字段

result[] 字段

refinement_chips 字段说明

refinement_chips.items[] 字段

refinement_chips.items[].options[] 字段

items[] 结果类型说明

1) ads_multi_account_advertiser

advertisers[] 字段

2) ads_advertiser

3) ads_domain

调用示例

cURL

Python

TypeScript

结果获取建议

响应示例

状态码说明

实用场景

获取 Google Ads Advertisers 高级结果（按任务 ID） ​

接口说明 ​

路径参数 ​

Sandbox 调试 ​

返回结果结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段 ​

refinement_chips 字段说明 ​

refinement_chips.items[] 字段 ​

refinement_chips.items[].options[] 字段 ​

items[] 结果类型说明 ​

1) ads_multi_account_advertiser ​

advertisers[] 字段 ​

2) ads_advertiser ​

3) ads_domain ​

调用示例 ​

cURL ​

Python ​

TypeScript ​

结果获取建议 ​

响应示例 ​

状态码说明 ​

实用场景 ​

获取 Google Ads Advertisers 高级结果（按任务 ID）

接口说明

路径参数

Sandbox 调试

返回结果结构

顶层字段

tasks[] 字段

result[] 字段

refinement_chips 字段说明

refinement_chips.items[] 字段

refinement_chips.items[].options[] 字段

items[] 结果类型说明

1) ads_multi_account_advertiser

advertisers[] 字段

2) ads_advertiser

3) ads_domain

调用示例

cURL

Python

TypeScript

结果获取建议

响应示例

状态码说明

实用场景