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 các khu vực khác nhau.
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 gửi đến Google AI Overview. |
country | string | Yes | Mã quốc gia hoặc khu vực. |
shopping | boolean | No | Có lấy dữ liệu mua sắm hay không. Mặc định là true. Khi được bật, phản hồi sẽ bao gồm thông tin sản phẩm bổ sung trong trường products — các ưu đãi của nhà bán hàng đằ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á cả, trả góp, tồn kho, giao hàng và đổi trả. |
location | string | No | Tên vị trí chuẩn của Google cho 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 | No | Chuỗi UULE của Google đã được mã hóa sẵn để nhắm mục tiêu địa lý chính xác. Sử dụng tùy chọn này khi bạn có giá trị UULE đã xây dựng sẵn thay vì tên vị trí. Loại trừ lẫn nhau với location. |
Response Fields
Note: 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ẽ bị tính phí ở mức gấp 2 lần tỷ lệ 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
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 hỗ trợ.
Data field 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 |
Data field Products: Sản phẩm được tài trợ Google wale
Data field 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ó 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 | Đá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 trích dẫn. |
source.thumbnail | string | Hình ả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 | 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 trích dẫn. |
web_source.thumbnail | string | Hình ả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 đề 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. |
products | array | Thông tin sản phẩm được trả về bởi Chế độ Google Overview. |
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, đổi trả). |
products.stores.price | string | Giá tại 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 phí. |
products.about_the_product | object | Thông tin chi tiết về sản phẩm. |
products.about_the_product.title | string | Tiêu đề phần. |
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 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 | 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 phối đá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á. |