Google AI Overview Scraper

scraper.overview thu thập các phản hồi Google AI Overview toàn diện, bao gồm dữ liệu sản phẩm được làm giàu, trích dẫn, quảng cáo và nguồn web để giúp bạn phân tích kết quả tìm kiếm trên các khu vực khác nhau.

Ví dụ Yêu cầu

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

Tham số Body

Parameter	Type	Required	Description
`prompt`	string	Có	Prompt gửi đến Google AI Overview.
`country`	string	Có	Mã quốc gia hoặc khu vực.
`shopping`	boolean	Không	Có thu thập dữ liệu mua sắm hay không. Mặc định là `true`. Khi được bật, phản hồi bao gồm thông tin sản phẩm bổ sung trong trường `products` — các ưu đãi từ người bán đằng sau mỗi cụm sản phẩm, chẳng hạn như URL cửa hàng trực tiếp, giá, trả góp, tồn kho, giao hàng và trả hàng.
`location`	string	Không	Tên vị trí chính tắc của Google cho các kết quả nhắm mục tiêu theo địa lý (ví dụ: New York,New York,United States). Xem danh sách mục tiêu địa lý của Google để biết tất cả các vị trí được hỗ trợ. Loại trừ lẫn nhau với uule.
`uule`	string	Không	Chuỗi Google UULE đã được mã hóa sẵn để nhắm mục tiêu địa lý chính xác. Sử dụng chuỗi này khi bạn có sẵn một giá trị UULE dựng sẵn thay vì tên vị trí. Loại trừ lẫn nhau với location.
`should_fetch_share_link`	boolean	Không	Lấy liên kết chia sẻ.

Các Trường Phản hồi

Lưu ý: Khi shopping được bật và phản hồi trả về thông tin sản phẩm bổ sung này, lệnh gọi API sẽ được tính phí gấp 2 lần mức phí cơ bản. Điều này là do chi phí tài nguyên bổ sung cần thiết để trích xuất và xử lý thông tin sản phẩm từ nhiều nguồn.

💡 Khi chế độ overview không được kích hoạt, cả trường content và rawtext đều sẽ là chuỗi rỗng.

💡 Để kích hoạt chế độ overview, bạn có thể thử điều chỉnh prompt của mình hoặc đảm bảo rằng các từ khóa trong prompt được Google Overview bao phủ.

Nguồn trường Data: sản phẩm bên trong ai overview

type	product_position	description
product	recommended	sản phẩm được đề xuất
product	inline_link	sản phẩm liên kết nội tuyến
product	reference	sản phẩm tham chiếu
ads product	null	sản phẩm quảng cáo

Trường Data Products: sản phẩm được tài trợ Google wale

Trường Data Ads: Google Ads(Serp)

Parameter	Type	Description
`content`	string	Nội dung câu trả lời ở định dạng Markdown. Chỉ được điền khi chế độ overview được kích hoạt; nếu không, nó sẽ là chuỗi rỗng.
`rawtext`	string	Dữ liệu câu trả lời gốc. Chỉ được điền khi chế độ overview được kích hoạt; nếu không, nó sẽ là chuỗi rỗng.
`metadata`	object	Thông tin metadata.
`metadata.rawUrl`	string	URL trang web.
`is_overview_shopping`	boolean	Có dữ liệu mua sắm được nhúng hay không.
`products`	array	Dữ liệu sản phẩm.
`products.delivery`	string	Dịch vụ giao hàng.
`products.discount`	string	Thông tin giảm giá.
`products.img`	string	URL hình ảnh sản phẩm.
`products.orig_price`	string	Giá gốc.
`products.rating`	string	Đánh giá.
`products.review_count`	string	Số lượng đánh giá.
`products.seller`	string	Người bán.
`products.url`	string	URL trang chi tiết sản phẩm.
`products.stores`	array	Thông tin cửa hàng.
`products.stores.delivery_fee`	string	Phí giao hàng.
`products.stores.extensions`	array	Dịch vụ bổ sung.
`products.stores.link`	string	Liên kết chuyển hướng sản phẩm.
`products.stores.name`	string	Tên cửa hàng.
`products.stores.price`	string	Giá bán.
`products.ratings`	string	Đánh giá.
`products.tag`	string	Thẻ.
`products.title`	string	Tiêu đề sản phẩm.
`products.total_price`	string	Tổng giá.
`source`	array	Nguồn trích dẫn.
`source.favicon`	string	Favicon trang web.
`source.snippet`	string	Đoạn trích bài viết trích dẫn.
`source.thumbnail`	string	Ảnh bìa bài viết trích dẫn.
`source.title`	string	Tiêu đề trích dẫn.
`source.type`	string	Loại nguồn.
`source.url`	string	URL gốc trích dẫn.
`source.website_name`	string	Tên trang web.
`source.html_index`	int	Cho biết vị trí của thẻ mua sắm sản phẩm được đề xuất trong nội dung Markdown.
`source.stores`	array	Thông tin cửa hàng.
`source.stores.delivery_fee`	string	Phí giao hàng.
`source.stores.extensions`	array	Dịch vụ bổ sung.
`source.stores.link`	string	Liên kết chuyển hướng sản phẩm.
`source.stores.name`	string	Tên cửa hàng.
`source.stores.price`	string	Giá bán.
`web_source`	array	Nguồn tìm kiếm web.
`web_source.favicon`	string	Favicon trang web.
`web_source.snippet`	string	Đoạn trích bài viết trích dẫn.
`web_source.thumbnail`	string	Ảnh bìa bài viết trích dẫn.
`web_source.title`	string	Tiêu đề trích dẫn.
`web_source.url`	string	URL gốc trích dẫn.
`web_source.website_name`	string	Tên trang web.
`web_source.stores`	array	Thông tin cửa hàng.
`web_source.stores.delivery_fee`	string	Phí giao hàng.
`web_source.stores.extensions`	array	Dịch vụ bổ sung.
`web_source.stores.link`	string	Liên kết chuyển hướng sản phẩm.
`web_source.stores.name`	string	Tên cửa hàng.
`web_source.stores.price`	string	Giá bán.
`ads`	array	Quảng cáo.
`ads.section_title`	string	Tiêu đề mục.
`ads.type`	string	Loại.
`ads.title`	string	Tiêu đề.
`ads.url`	string	URL trang web.
`ads.google_ad_url`	string	Liên kết quảng cáo.
`ads.display_url`	string	URL hiển thị.
`ads.advertiser`	string	Nhà quảng cáo.
`ads.description`	string	Mô tả.
`ads.tracking_token`	string	Token theo dõi.
`ads.slot`	string	Số vị trí quảng cáo.
`ads.price`	string	Giá.
`ads.orig_price`	string	Giá gốc.
`ads.seller`	string	Người bán.
`ads.rating`	string	Đánh giá.
`ads.review_count`	string	Số lượng đánh giá.
`ads.img`	string	URL hình ảnh sản phẩm.
`ads.site_links`	array	Liên kết trang web.
`ads.site_links.title`	string	Tiêu đề.
`ads.site_links.url`	string	URL trang web.
`ads.site_links.google_ad_url`	string	Liên kết quảng cáo.
`products`	array	Thông tin sản phẩm được trả về bởi Google Overview Mode.
`products.thumbnails`	array	Mảng các URL hình ảnh thu nhỏ của sản phẩm.
`products.title`	string	Tiêu đề sản phẩm.
`products.url`	string	URL trang sản phẩm.
`products.brand`	string	Tên thương hiệu sản phẩm.
`products.reviews`	int	Số lượng đánh giá.
`products.rating`	string	Điểm đánh giá trung bình.
`products.price_range`	string	Khoảng giá, ví dụ, `$2,499.99`.
`products.stores`	array	Mảng các ưu đãi từ cửa hàng.
`products.stores.name`	string	Tên cửa hàng.
`products.stores.link`	string	Liên kết sản phẩm tại cửa hàng.
`products.stores.title`	string	Tiêu đề sản phẩm tại cửa hàng.
`products.stores.ratings`	string	Đánh giá cửa hàng, ví dụ, `4.3/5`.
`products.stores.extensions`	array	Thông tin bổ sung (tồn kho, giao hàng, trả hàng).
`products.stores.price`	string	Giá cửa hàng.
`products.stores.delivery_fee`	string	Thông tin phí giao hàng.
`products.stores.total_price`	string	Tổng giá bao gồm các khoản phí.
`products.about_the_product`	object	Thông tin sản phẩm chi tiết.
`products.about_the_product.title`	string	Tiêu đề mục.
`products.about_the_product.link`	string	Liên kết trang sản phẩm.
`products.about_the_product.displayed_link`	string	Tên miền được hiển thị.
`products.about_the_product.features`	array	Tính năng/thông số kỹ thuật sản phẩm.
`products.about_the_product.features.title`	string	Tên tính năng.
`products.about_the_product.features.value`	string	Giá trị tính năng.
`products.about_the_product.description`	string	Mô tả sản phẩm.
`products.variants`	array	Các tùy chọn biến thể sản phẩm.
`products.variants.title`	string	Tiêu đề danh mục biến thể.
`products.variants.items`	array	Danh sách tùy chọn biến thể.
`products.variants.items.name`	string	Tên tùy chọn biến thể.
`products.variants.items.selected`	bool	Biến thể này có được chọn hay không.
`products.variants.items.availability`	bool	Trạng thái khả dụng của biến thể.
`products.ratings`	array	Dữ liệu phân bố đánh giá.
`products.ratings.stars`	int	Mức đánh giá sao (1-5).
`products.ratings.amount`	int	Số lượng đánh giá ở mức này.
`products.user_reviews`	array	Dữ liệu đánh giá của người dùng.
`products.user_reviews.text`	string	Nội dung văn bản đánh giá.
`products.user_reviews.source`	string	Nền tảng nguồn đánh giá.
`products.user_reviews.rating`	int	Điểm đánh giá của người dùng.
`products.user_reviews.date`	string	Ngày đánh giá.
`products.user_reviews.name`	string	Tên người đánh giá.
`products.user_reviews.title`	string	Tiêu đề đánh giá.
`share_url`	string	Liên kết chia sẻ.

Google AI Mode Grok