Google AI Overview Scraper

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

请求示例

curl 'https://api.scrapeless.com/api/v2/scraper/request' \
--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"
    }
}'

请求体参数

Parameter	Type	Required	Description
`prompt`	string	是	发送给 Google AI Overview 的提示词。
`country`	string	是	国家或地区代码。
`shopping`	boolean	否	是否获取购物数据。默认为 `true`。启用后，响应会在 `products` 字段中包含额外的产品信息——每个产品聚类背后的商家报价，例如直达店铺 URL、价格、分期付款、库存、配送和退货等。
`location`	string	否	用于地理定位结果的 Google 规范位置名称（例如 New York,New York,United States）。所有支持的位置请参见 Google 的地理目标列表。与 uule 互斥。
`uule`	string	否	预编码的 Google UULE 字符串，用于精确地理定位。当你已有预先构建的 UULE 值而非位置名称时使用。与 location 互斥。
`should_fetch_share_link`	boolean	否	获取分享链接。

响应字段

注意： 当启用 shopping 且响应返回这些额外产品信息时，该 API 调用将按 基础费率的 2 倍 计费。这是由于从多个来源提取和处理产品信息所需的额外资源开销。

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

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

数据字段 Source： AI overview 内的产品

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

数据字段 Products： Google 站内赞助产品

数据字段 Ads： Google Ads（Serp）

Parameter	Type	Description
`content`	string	Markdown 格式的答案正文。仅在触发 overview 模式时填充；否则为空字符串。
`rawtext`	string	原始答案数据。仅在触发 overview 模式时填充；否则为空字符串。
`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	广告链接。
`products`	array	Google Overview Mode 返回的产品信息。
`products.thumbnails`	array	产品缩略图 URL 数组。
`products.title`	string	产品标题。
`products.url`	string	产品页面 URL。
`products.brand`	string	产品品牌名称。
`products.reviews`	int	评论数量。
`products.rating`	string	平均评分。
`products.price_range`	string	价格区间，例如 `$2,499.99`。
`products.stores`	array	店铺报价数组。
`products.stores.name`	string	店铺名称。
`products.stores.link`	string	店铺产品链接。
`products.stores.title`	string	店铺中的产品标题。
`products.stores.ratings`	string	店铺评分，例如 `4.3/5`。
`products.stores.extensions`	array	附加信息（库存、配送、退货）。
`products.stores.price`	string	店铺价格。
`products.stores.delivery_fee`	string	配送费信息。
`products.stores.total_price`	string	含费用总价。
`products.about_the_product`	object	详细产品信息。
`products.about_the_product.title`	string	版块标题。
`products.about_the_product.link`	string	产品页面链接。
`products.about_the_product.displayed_link`	string	显示的域名。
`products.about_the_product.features`	array	产品特性/规格。
`products.about_the_product.features.title`	string	特性名称。
`products.about_the_product.features.value`	string	特性值。
`products.about_the_product.description`	string	产品描述。
`products.variants`	array	产品变体选项。
`products.variants.title`	string	变体类别标题。
`products.variants.items`	array	变体选项列表。
`products.variants.items.name`	string	变体选项名称。
`products.variants.items.selected`	bool	是否选中该变体。
`products.variants.items.availability`	bool	变体可用状态。
`products.ratings`	array	评分分布数据。
`products.ratings.stars`	int	星级评分等级（1-5）。
`products.ratings.amount`	int	该等级的评分数量。
`products.user_reviews`	array	用户评论数据。
`products.user_reviews.text`	string	评论文本内容。
`products.user_reviews.source`	string	评论来源平台。
`products.user_reviews.rating`	int	用户评分。
`products.user_reviews.date`	string	评论日期。
`products.user_reviews.name`	string	评论者名称。
`products.user_reviews.title`	string	评论标题。
`share_url`	string	分享链接。

Google AI Mode Grok