Google AI Overview 爬虫

scraper.overview 可捕获全面的 Google AI Overview 响应，包括丰富的产品数据、引用、广告和网络来源，帮助您分析不同地区的搜索结果。

请求示例

curl '{api_host}/api/v2/scraper/execute' \
--header 'Content-Type: application/json' \
--header 'x-api-token: {you_api_key}' \
--data '{
    "actor": "scraper.overview",
    "input": {
        "prompt": "Recommended attractions in New York",
        "country": "US",
        "shopping": true
    },
    "webhook": {
        "url": "http://www.youwebhook.com"
    }
}'

请求体参数

参数	类型	是否必需	描述
`prompt`	string	是	发送给 Google AI Overview 的提示词。
`country`	string	是	国家或地区。
`shopping`	boolean	否	是否获取购物数据。默认为 `true`。启用时，将在 `products` 字段中返回产品信息。

响应字段

注意： 如果响应包含购物数据（products 字段），该 API 调用将按基础费率的 2 倍计费。这是由于从多个来源提取和处理产品信息需要额外的资源开销。

💡 当未触发概述模式时，content 和 rawtext 字段均将为空字符串。

💡 要触发概述模式，您可以尝试调整提示词，或确保提示词中的关键词被 Google Overview 覆盖。

数据字段 Source： AI 概述内的产品

type	product_position	description
product	recommended	推荐产品
product	inline_link	内联链接产品
product	reference	参考产品
ads product	null	广告产品

数据字段 Products： Google 赞助产品

数据字段 Ads： Google 广告 (Serp)

参数	类型	描述
`content`	string	Markdown 格式的回复正文。仅在触发概述模式时填充；否则为空字符串。
`rawtext`	string	原始回复数据。仅在触发概述模式时填充；否则为空字符串。
`metadata`	object	元数据信息。
`metadata.rawUrl`	string	网页 URL。
`is_overview_shopping`	boolean	是否包含嵌入的购物数据。
`products`	array	产品数据。
`products.delivery`	string	配送服务。
`products.discount`	string	折扣信息。
`products.img`	string	产品图片 URL。
`products.orig_price`	string	原价。
`products.rating`	string	评分。
`products.review_count`	string	评论数量。
`products.seller`	string	卖家。
`products.url`	string	产品详情页 URL。
`products.stores`	array	店铺信息。
`products.stores.delivery_fee`	string	配送费。
`products.stores.extensions`	array	附加服务。
`products.stores.link`	string	产品跳转链接。
`products.stores.name`	string	店铺名称。
`products.stores.price`	string	售价。
`products.ratings`	string	评分。
`products.tag`	string	标签。
`products.title`	string	产品标题。
`products.total_price`	string	总价。
`source`	array	引用来源。
`source.favicon`	string	网站图标。
`source.snippet`	string	引用文章摘要。
`source.thumbnail`	string	引用文章封面图。
`source.title`	string	引用标题。
`source.type`	string	来源类型。
`source.url`	string	引用原始 URL。
`source.website_name`	string	网站名称。
`source.html_index`	int	表示推荐产品购物卡在 Markdown 内容中的位置。
`source.stores`	array	店铺信息。
`source.stores.delivery_fee`	string	配送费。
`source.stores.extensions`	array	附加服务。
`source.stores.link`	string	产品跳转链接。
`source.stores.name`	string	店铺名称。
`source.stores.price`	string	售价。
`web_source`	array	网络搜索来源。
`web_source.favicon`	string	网站图标。
`web_source.snippet`	string	引用文章摘要。
`web_source.thumbnail`	string	引用文章封面图。
`web_source.title`	string	引用标题。
`web_source.url`	string	引用原始 URL。
`web_source.website_name`	string	网站名称。
`web_source.stores`	array	店铺信息。
`web_source.stores.delivery_fee`	string	配送费。
`web_source.stores.extensions`	array	附加服务。
`web_source.stores.link`	string	产品跳转链接。
`web_source.stores.name`	string	店铺名称。
`web_source.stores.price`	string	售价。
`ads`	array	广告。
`ads.section_title`	string	区块标题。
`ads.type`	string	类型。
`ads.title`	string	标题。
`ads.url`	string	网页 URL。
`ads.google_ad_url`	string	广告链接。
`ads.display_url`	string	显示 URL。
`ads.advertiser`	string	广告主。
`ads.description`	string	描述。
`ads.tracking_token`	string	追踪令牌。
`ads.slot`	string	广告位编号。
`ads.price`	string	价格。
`ads.orig_price`	string	原价。
`ads.seller`	string	卖家。
`ads.rating`	string	评分。
`ads.review_count`	string	评论数量。
`ads.img`	string	产品图片 URL。
`ads.site_links`	array	网站链接。
`ads.site_links.title`	string	标题。
`ads.site_links.url`	string	网页 URL。
`ads.site_links.google_ad_url`	string	广告链接。

Google AI 模式 Grok