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ệu | Bắt buộc | Mô tả |
|---|---|---|---|
prompt | string | Có | Prompt gửi đến Google AI Overview. |
country | string | Có | Quốc gia hoặc khu vực. |
shopping | boolean | Không | Có 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
contentvàrawtextsẽ 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
| 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 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ệu | Mô tả |
|---|---|---|
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à một 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à một chuỗi rỗng. |
metadata | object | Thông tin metadata. |
metadata.rawUrl | string | URL trang web. |
is_overview_shopping | boolean | Có chứa 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 | Các đánh giá. |
products.tag | string | Thẻ (tags). |
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 nguồn. |
source.thumbnail | string | Hình ảnh bìa bài viết nguồn. |
source.title | string | Tiêu đề trích dẫn. |
source.type | string | Loại nguồn. |
source.url | string | URL gốc của trích dẫn. |
source.website_name | string | Tên trang web. |
source.html_index | int | Chỉ 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 nguồn. |
web_source.thumbnail | string | Hình ảnh bìa bài viết nguồn. |
web_source.title | string | Tiêu đề trích dẫn. |
web_source.url | string | URL gốc của 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 đề phần. |
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. |