Ads Max

抓取针对最大付费广告可见性优化的 Google 搜索结果,解析付费广告、自然结果、知识图谱面板、图片轮播等数据。

google_ads 该源针对检索包含付费广告的 Google 搜索(SERP)和 Google AI Overviews 结果进行了优化,付费广告的出现频率为 最高广告比率。该源每页仅返回十个结果,以确保付费结果出现的最高概率。除此之外,它支持与常规相同的参数 Web Searcharrow-up-right.

请求示例

在此示例中,我们发出请求以检索关键词的搜索结果 adidas。

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_ads", 
        "query": "adidas",
        "parse": true
    }'

我们在示例中使用同步 Realtime 集成方法。如果您想使用 Proxy Endpoint 或异步 Push-Pull 集成,请参阅 集成方法 部分。

请求参数值

通用

用于抓取 Google 广告的基本设置和自定义选项。

参数
描述
默认值

source

设置爬虫。

google_ads

query

要搜索的关键词或短语。

-

render

当设置为时启用 JavaScript 渲染 html. 更多信息.

-

parse

当设置为时返回解析后的数据 true。查看输出 数据字典.

false

callback_url

回调端点的 URL。 更多信息.

-

user_agent_type

设备类型和浏览器。完整列表可在 here.

desktop

- 必填参数

本地化

将搜索结果适配到特定地理位置和语言。

参数
描述
默认值

geo_location

应适配结果的地理位置。正确使用此参数对于获取正确数据非常重要。有关更多信息,请阅读我们建议的 geo_location 参数结构 here.

-

locale

Accept-Language 标头值,用于更改您 Google 搜索页面的网页界面语言。 更多信息.

-

context: results_language

结果语言。受支持的 Google 语言列表可在 here.

-

分页

用于管理搜索结果分页和检索的控制项。

参数
描述
默认值

start_page

起始页码。

1

pages

要检索的页数。

1

过滤

用于根据各种条件过滤和优化搜索结果的选项。

参数
描述
默认值

context:

udm

udm 参数允许在不同的搜索选项卡(例如图片、地点或视频)之间切换,以自定义显示的结果类型。查找可接受的值 herearrow-up-right.

-

context: tbm

待匹配或 tbm 参数。可接受的值为: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

-

context: tbs

tbs 参数。该参数类似于一个容器,用于更晦涩的 Google 参数,例如按日期限制/排序结果,以及其他某些依赖于 tbm 参数(例如 tbs=app_os:1 仅在与 tbmapp一起使用时可用)。更多信息 herearrow-up-right.

-

其他

用于特殊需求的其他高级设置和控制项。

参数
描述
默认值

context: nfpr

true 将关闭拼写自动更正

false

上下文参数

所有上下文参数应作为对象添加到 context 数组,形式为具有 对,例如:

输出示例

输出字典

google_ads 输出包含 URL、页面、结果等字段。下表列出我们解析的每个 Google Ads Max 元素的详细清单,包括描述、数据类型和相关元数据。

circle-info

特定结果类型的项目和字段数量可能会根据搜索查询而变化。

键名
描述
类型

url

Google 搜索结果页面的 URL。

字符串

page

页码。

整数

结果

包含所有搜索结果类型的对象。

对象

results.paid

付费广告结果列表,包含标题、描述、URL 和站点链接等详细信息。

数组

results.organic

自然(非付费)搜索结果列表,包含标题、描述、URL 和站点链接。

数组

results.images

在搜索页面上显示的图片轮播结果。

对象

results.knowledge

知识图谱面板数据,包括标题、描述、图片、事实要点和相关搜索。

对象

results.navigation

用于在搜索类型之间切换的导航标签(图片、视频、新闻等)。

数组

results.instant_answers

页面上显示的特殊功能或即时答案框。

数组

results.related_searches

包含查询及其位置的相关搜索建议。

对象

results.search_information

关于搜索的元数据,包括查询和总结果数。

对象

results.total_results_count

该查询的估计总结果数。

整数

parse_status_code

解析操作的状态代码。

整数

created_at

抓取任务创建的时间戳。

timestamp

updated_at

抓取任务完成的时间戳。

timestamp

job_id

与抓取任务关联的作业 ID。

字符串

status_code

抓取任务的状态代码。你可以在其中看到爬虫状态代码的描述 herearrow-up-right.

整数

最后更新于

这有帮助吗?