Google AI Overview Scraper

scraper.overview thu thập toàn diện các phản hồi từ Google AI Overview, bao gồm dữ liệu sản phẩm phong phú, 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 nhiều khu vực khác nhau.

Ví dụ Yêu cầu

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

Tham số Body

Tham sốKiểu dữ liệuBắt buộcMô tả
promptstringPrompt gửi đến Google AI Overview.
countrystringQuốc gia hoặc khu vực.
shoppingbooleanKhôngCó lấy dữ liệu mua sắm hay không. Mặc định là true. Khi bật, sẽ trả về thông tin sản phẩm trong trường products.

Trường Phản hồi

Lưu ý: Nếu phản hồi bao gồm dữ liệu mua sắm (trường products), lệnh gọi API sẽ bị tính phí ở mức gấp 2 lần mức 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ả hai trường contentrawtext sẽ là chuỗi rỗng.

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

Trường dữ liệu Source: sản phẩm bên trong ai overview

typeproduct_positiondescription
productrecommendedsản phẩm được đề xuất
productinline_linksản phẩm liên kết nội tuyến
productreferencesản phẩm tham chiếu
ads productnullsản phẩm quảng cáo

Trường dữ liệu Products: Sản phẩm được tài trợ bởi Google

Trường dữ liệu Ads: Google Ads (Serp)

Tham sốKiểu dữ liệuMô tả
contentstringNộ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à một chuỗi rỗng.
rawtextstringDữ 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à một chuỗi rỗng.
metadataobjectThông tin metadata.
metadata.rawUrlstringURL trang web.
is_overview_shoppingbooleanCó chứa dữ liệu mua sắm được nhúng hay không.
productsarrayDữ liệu sản phẩm.
products.deliverystringDịch vụ giao hàng.
products.discountstringThông tin giảm giá.
products.imgstringURL hình ảnh sản phẩm.
products.orig_pricestringGiá gốc.
products.ratingstringĐánh giá.
products.review_countstringSố lượng đánh giá.
products.sellerstringNgười bán.
products.urlstringURL trang chi tiết sản phẩm.
products.storesarrayThông tin cửa hàng.
products.stores.delivery_feestringPhí giao hàng.
products.stores.extensionsarrayDịch vụ bổ sung.
products.stores.linkstringLiên kết chuyển hướng sản phẩm.
products.stores.namestringTên cửa hàng.
products.stores.pricestringGiá bán.
products.ratingsstringCác đánh giá.
products.tagstringThẻ (tags).
products.titlestringTiêu đề sản phẩm.
products.total_pricestringTổng giá.
sourcearrayNguồn trích dẫn.
source.faviconstringFavicon trang web.
source.snippetstringĐoạn trích bài viết nguồn.
source.thumbnailstringHình ảnh bìa bài viết nguồn.
source.titlestringTiêu đề trích dẫn.
source.typestringLoại nguồn.
source.urlstringURL gốc của trích dẫn.
source.website_namestringTên trang web.
source.html_indexintChỉ vị trí của thẻ mua sắm sản phẩm được đề xuất trong nội dung Markdown.
source.storesarrayThông tin cửa hàng.
source.stores.delivery_feestringPhí giao hàng.
source.stores.extensionsarrayDịch vụ bổ sung.
source.stores.linkstringLiên kết chuyển hướng sản phẩm.
source.stores.namestringTên cửa hàng.
source.stores.pricestringGiá bán.
web_sourcearrayNguồn tìm kiếm web.
web_source.faviconstringFavicon trang web.
web_source.snippetstringĐoạn trích bài viết nguồn.
web_source.thumbnailstringHình ảnh bìa bài viết nguồn.
web_source.titlestringTiêu đề trích dẫn.
web_source.urlstringURL gốc của trích dẫn.
web_source.website_namestringTên trang web.
web_source.storesarrayThông tin cửa hàng.
web_source.stores.delivery_feestringPhí giao hàng.
web_source.stores.extensionsarrayDịch vụ bổ sung.
web_source.stores.linkstringLiên kết chuyển hướng sản phẩm.
web_source.stores.namestringTên cửa hàng.
web_source.stores.pricestringGiá bán.
adsarrayQuảng cáo.
ads.section_titlestringTiêu đề phần.
ads.typestringLoại.
ads.titlestringTiêu đề.
ads.urlstringURL trang web.
ads.google_ad_urlstringLiên kết quảng cáo.
ads.display_urlstringURL hiển thị.
ads.advertiserstringNhà quảng cáo.
ads.descriptionstringMô tả.
ads.tracking_tokenstringToken theo dõi.
ads.slotstringSố vị trí quảng cáo.
ads.pricestringGiá.
ads.orig_pricestringGiá gốc.
ads.sellerstringNgười bán.
ads.ratingstringĐánh giá.
ads.review_countstringSố lượng đánh giá.
ads.imgstringURL hình ảnh sản phẩm.
ads.site_linksarrayLiên kết trang web.
ads.site_links.titlestringTiêu đề.
ads.site_links.urlstringURL trang web.
ads.site_links.google_ad_urlstringLiên kết quảng cáo.