Google AI Overview Scraper

scraper.overview captures comprehensive Google AI Overview responses, including enriched product data, citations, advertisements, and web sources to help you analyze search results across different regions.

Request Example

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"
    }
}'

Body Parameters

Parameter	Type	Required	Description
`prompt`	string	Yes	Prompt sent to Google AI Overview.
`country`	string	Yes	Country or region code.
`shopping`	boolean	No	Whether to fetch shopping data. Defaults to `true`. When enabled, the response includes extra product information in the `products` field — the merchant offers behind each product cluster, such as direct store URL, price, installments, stock, delivery, and returns.
`location`	string	No	Google canonical location name for geo-targeted results (e.g., New York,New York,United States). See Google’s geo target list for all supported locations. Mutually exclusive with uule.
`uule`	string	No	Pre-encoded Google UULE string for precise geo-targeting. Use this when you have a pre-built UULE value instead of a location name. Mutually exclusive with location.

Response Fields

Note: When shopping is enabled and the response returns this extra product information, the API call will be charged at 2x the base rate. This is due to the additional resource overhead required for extracting and processing product information from multiple sources.

💡 When the overview mode is not triggered, both content and rawtext fields will be empty strings.

💡 To trigger the overview mode, you can try adjusting your prompt or ensuring that the keywords in your prompt are covered by Google Overview.

Data field Source: products inside ai overview

type	product_position	description
product	recommended	recommended products
product	inline_link	inline link products
product	reference	reference products
ads product	null	ads products

Data field Products: Google wale sponsored products

Data field Ads: Google Ads(Serp)

Parameter	Type	Description
`content`	string	Answer body in Markdown format. Only populated when overview mode is triggered; otherwise, it will be an empty string.
`rawtext`	string	Original answer data. Only populated when overview mode is triggered; otherwise, it will be an empty string.
`metadata`	object	Metadata information.
`metadata.rawUrl`	string	Webpage URL.
`is_overview_shopping`	boolean	Whether there is embedded shopping data.
`products`	array	Product data.
`products.delivery`	string	Delivery service.
`products.discount`	string	Discount information.
`products.img`	string	Product image URL.
`products.orig_price`	string	Original price.
`products.rating`	string	Rating.
`products.review_count`	string	Number of reviews.
`products.seller`	string	Seller.
`products.url`	string	Product detail page URL.
`products.stores`	array	Store information.
`products.stores.delivery_fee`	string	Delivery fee.
`products.stores.extensions`	array	Additional services.
`products.stores.link`	string	Product redirect link.
`products.stores.name`	string	Store name.
`products.stores.price`	string	Sale price.
`products.ratings`	string	Ratings.
`products.tag`	string	Tags.
`products.title`	string	Product title.
`products.total_price`	string	Total price.
`source`	array	Citation sources.
`source.favicon`	string	Website favicon.
`source.snippet`	string	Citation article snippet.
`source.thumbnail`	string	Citation article cover image.
`source.title`	string	Citation title.
`source.type`	string	Source Type.
`source.url`	string	Citation original URL.
`source.website_name`	string	Website name.
`source.html_index`	int	Indicates the position of the recommended product shopping card in the Markdown content.
`source.stores`	array	Store information.
`source.stores.delivery_fee`	string	Delivery fee.
`source.stores.extensions`	array	Additional services.
`source.stores.link`	string	Product redirect link.
`source.stores.name`	string	Store name.
`source.stores.price`	string	Sale price.
`web_source`	array	Web search sources.
`web_source.favicon`	string	Website favicon.
`web_source.snippet`	string	Citation article snippet.
`web_source.thumbnail`	string	Citation article cover image.
`web_source.title`	string	Citation title.
`web_source.url`	string	Citation original URL.
`web_source.website_name`	string	Website name.
`web_source.stores`	array	Store information.
`web_source.stores.delivery_fee`	string	Delivery fee.
`web_source.stores.extensions`	array	Additional services.
`web_source.stores.link`	string	Product redirect link.
`web_source.stores.name`	string	Store name.
`web_source.stores.price`	string	Sale price.
`ads`	array	Advertisements.
`ads.section_title`	string	Section title.
`ads.type`	string	Type.
`ads.title`	string	Title.
`ads.url`	string	Webpage URL.
`ads.google_ad_url`	string	Advertisement link.
`ads.display_url`	string	Display URL.
`ads.advertiser`	string	Advertiser.
`ads.description`	string	Description.
`ads.tracking_token`	string	Tracking token.
`ads.slot`	string	Ad slot number.
`ads.price`	string	Price.
`ads.orig_price`	string	Original price.
`ads.seller`	string	Seller.
`ads.rating`	string	Rating.
`ads.review_count`	string	Number of reviews.
`ads.img`	string	Product image URL.
`ads.site_links`	array	Website links.
`ads.site_links.title`	string	Title.
`ads.site_links.url`	string	Webpage URL.
`ads.site_links.google_ad_url`	string	Advertisement link.
`products`	array	Product information returned by Google Overview Mode.
`products.thumbnails`	array	Array of product thumbnail image URLs.
`products.title`	string	Product title.
`products.url`	string	Product page URL.
`products.brand`	string	Product brand name.
`products.reviews`	int	Number of reviews.
`products.rating`	string	Average rating score.
`products.price_range`	string	Price range, e.g., `$2,499.99`.
`products.stores`	array	Array of store offers.
`products.stores.name`	string	Store name.
`products.stores.link`	string	Store product link.
`products.stores.title`	string	Product title at the store.
`products.stores.ratings`	string	Store rating, e.g., `4.3/5`.
`products.stores.extensions`	array	Additional info (stock, delivery, returns).
`products.stores.price`	string	Store price.
`products.stores.delivery_fee`	string	Delivery fee information.
`products.stores.total_price`	string	Total price including fees.
`products.about_the_product`	object	Detailed product information.
`products.about_the_product.title`	string	Section title.
`products.about_the_product.link`	string	Product page link.
`products.about_the_product.displayed_link`	string	Displayed domain name.
`products.about_the_product.features`	array	Product features/specifications.
`products.about_the_product.features.title`	string	Feature name.
`products.about_the_product.features.value`	string	Feature value.
`products.about_the_product.description`	string	Product description.
`products.variants`	array	Product variant options.
`products.variants.title`	string	Variant category title.
`products.variants.items`	array	Variant options list.
`products.variants.items.name`	string	Variant option name.
`products.variants.items.selected`	bool	Whether this variant is selected.
`products.variants.items.availability`	bool	Variant availability status.
`products.ratings`	array	Rating distribution data.
`products.ratings.stars`	int	Star rating level (1-5).
`products.ratings.amount`	int	Number of ratings at this level.
`products.user_reviews`	array	User review data.
`products.user_reviews.text`	string	Review text content.
`products.user_reviews.source`	string	Review source platform.
`products.user_reviews.rating`	int	User rating score.
`products.user_reviews.date`	string	Review date.
`products.user_reviews.name`	string	Reviewer name.
`products.user_reviews.title`	string	Review title.

Google AI Mode Grok