Google AI Overview Scraper
scraper.overview captura respuestas completas de Google AI Overview, incluyendo datos enriquecidos de productos, citas, anuncios y fuentes web para ayudarle a analizar resultados de búsqueda en diferentes regiones.
Ejemplo de solicitud
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"
}
}'Parámetros del cuerpo
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
prompt | string | Sí | Prompt enviado a Google AI Overview. |
country | string | Sí | Código del país o región. |
shopping | boolean | No | Indica si se deben obtener datos de compras. El valor predeterminado es true. Cuando está habilitado, la respuesta incluye información adicional sobre productos en el campo products —las ofertas de comerciantes detrás de cada grupo de productos, como URL directa de la tienda, precio, cuotas, stock, entrega y devoluciones. |
location | string | No | Nombre canónico de ubicación de Google para resultados geodirigidos (por ejemplo, Nueva York, Nueva York, Estados Unidos). Consulte la lista de ubicaciones geográficas admitidas por Google para ver todas las ubicaciones compatibles. Exclusivo con uule. |
uule | string | No | Cadena UULE pre-codificada de Google para geolocalización precisa. Utilice este parámetro cuando tenga un valor UULE ya construido en lugar de un nombre de ubicación. Exclusivo con location. |
should_fetch_share_link | boolean | No | Obtener enlace para compartir. |
Campos de respuesta
Nota: Cuando
shoppingestá habilitado y la respuesta incluye esta información adicional del producto, la llamada a la API se cobra a 2 veces la tarifa base. Esto se debe a los recursos adicionales necesarios para extraer y procesar información de productos de varias fuentes.💡 Cuando el modo overview no se activa, ambos campos
contentyrawtextestarán vacíos.💡 Para activar el modo overview, puede intentar ajustar su prompt o asegurarse de que las palabras clave en su prompt estén cubiertas por Google Overview.
Campo de datos Fuente: productos dentro del resumen de IA
| type | product_position | descripción |
|---|---|---|
| product | recomendado | productos recomendados |
| product | inline_link | productos con enlaces en línea |
| product | referencia | productos de referencia |
| producto de anuncios | null | productos de anuncios |
Campo de datos Productos: productos patrocinados por Google
Campo de datos Anuncios: Google Ads (Serp)
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Cuerpo de la respuesta en formato Markdown. Solo se rellena cuando se activa el modo de descripción general; de lo contrario, será una cadena vacía. |
rawtext | string | Datos originales de la respuesta. Solo se rellena cuando se activa el modo de descripción general; de lo contrario, será una cadena vacía. |
metadata | object | Información de metadatos. |
metadata.rawUrl | string | URL de la página web. |
is_overview_shopping | boolean | Indica si hay datos de compras integrados. |
products | array | Datos del producto. |
products.delivery | string | Servicio de entrega. |
products.discount | string | Información sobre descuentos. |
products.img | string | URL de la imagen del producto. |
products.orig_price | string | Precio original. |
products.rating | string | Calificación. |
products.review_count | string | Número de reseñas. |
products.seller | string | Vendedor. |
products.url | string | URL de la página de detalles del producto. |
products.stores | array | Información de la tienda. |
products.stores.delivery_fee | string | Tarifa de envío. |
products.stores.extensions | array | Servicios adicionales. |
products.stores.link | string | Enlace de redirección del producto. |
products.stores.name | string | Nombre de la tienda. |
products.stores.price | string | Precio de oferta. |
products.ratings | string | Calificaciones. |
products.tag | string | Etiquetas. |
products.title | string | Título del producto. |
products.total_price | string | Precio total. |
source | array | Fuentes de citas. |
source.favicon | string | Favicon del sitio web. |
source.snippet | string | Extracto del artículo citado. |
source.thumbnail | string | Imagen de portada del artículo citado. |
source.title | string | Título de la cita. |
source.type | string | Tipo de fuente. |
source.url | string | URL original de la cita. |
source.website_name | string | Nombre del sitio web. |
source.html_index | int | Indica la posición de la tarjeta de compra del producto recomendado en el contenido Markdown. |
source.stores | array | Información de la tienda. |
source.stores.delivery_fee | string | Tarifa de envío. |
source.stores.extensions | array | Servicios adicionales. |
source.stores.link | string | Enlace de redirección del producto. |
source.stores.name | string | Nombre de la tienda. |
source.stores.price | string | Precio de oferta. |
web_source | array | Fuentes de búsqueda web. |
web_source.favicon | string | Favicon del sitio web. |
web_source.snippet | string | Extracto del artículo citado. |
web_source.thumbnail | string | Imagen de portada del artículo citado. |
web_source.title | string | Título de la cita. |
web_source.url | string | URL original de la cita. |
web_source.website_name | string | Nombre del sitio web. |
web_source.stores | array | Información de la tienda. |
web_source.stores.delivery_fee | string | Tarifa de envío. |
web_source.stores.extensions | array | Servicios adicionales. |
web_source.stores.link | string | Enlace de redirección del producto. |
web_source.stores.name | string | Nombre de la tienda. |
web_source.stores.price | string | Precio de oferta. |
ads | array | Anuncios. |
ads.section_title | string | Título de la sección. |
ads.type | string | Tipo. |
ads.title | string | Título. |
ads.url | string | URL de la página web. |
ads.google_ad_url | string | Enlace del anuncio. |
ads.display_url | string | URL mostrada. |
ads.advertiser | string | Anunciante. |
ads.description | string | Descripción. |
ads.tracking_token | string | Token de seguimiento. |
ads.slot | string | Número de ranura del anuncio. |
ads.price | string | Precio. |
ads.orig_price | string | Precio original. |
ads.seller | string | Vendedor. |
ads.rating | string | Calificación. |
ads.review_count | string | Número de reseñas. |
ads.img | string | URL de la imagen del producto. |
ads.site_links | array | Enlaces del sitio web. |
ads.site_links.title | string | Título. |
ads.site_links.url | string | URL de la página web. |
ads.site_links.google_ad_url | string | Enlace del anuncio. |
products | array | Información del producto devuelta por el modo de resumen de Google. |
products.thumbnails | array | Matriz de URLs de imágenes en miniatura del producto. |
products.title | string | Título del producto. |
products.url | string | URL de la página del producto. |
products.brand | string | Nombre de la marca del producto. |
products.reviews | int | Número de reseñas. |
products.rating | string | Puntuación media de valoración. |
products.price_range | string | Rango de precios, por ejemplo, $2,499.99. |
products.stores | array | Matriz de ofertas de tiendas. |
products.stores.name | string | Nombre de la tienda. |
products.stores.link | string | Enlace al producto en la tienda. |
products.stores.title | string | Título del producto en la tienda. |
products.stores.ratings | string | Calificación de la tienda, por ejemplo, 4.3/5. |
products.stores.extensions | array | Información adicional (disponibilidad, entrega, devoluciones). |
products.stores.price | string | Precio en la tienda. |
products.stores.delivery_fee | string | Información sobre la tarifa de envío. |
products.stores.total_price | string | Precio total incluyendo tarifas. |
products.about_the_product | object | Información detallada del producto. |
products.about_the_product.title | string | Título de la sección. |
products.about_the_product.link | string | Enlace a la página del producto. |
products.about_the_product.displayed_link | string | Nombre de dominio mostrado. |
products.about_the_product.features | array | Características/especificaciones del producto. |
products.about_the_product.features.title | string | Nombre de la característica. |
products.about_the_product.features.value | string | Valor de la característica. |
products.about_the_product.description | string | Descripción del producto. |
products.variants | array | Opciones de variante del producto. |
products.variants.title | string | Título de la categoría de variante. |
products.variants.items | array | Lista de opciones de variante. |
products.variants.items.name | string | Nombre de la opción de variante. |
products.variants.items.selected | bool | Indica si esta variante está seleccionada. |
products.variants.items.availability | bool | Estado de disponibilidad de la variante. |
products.ratings | array | Datos de distribución de calificaciones. |
products.ratings.stars | int | Nivel de calificación en estrellas (1-5). |
products.ratings.amount | int | Número de calificaciones en este nivel. |
products.user_reviews | array | Datos de reseñas de usuarios. |
products.user_reviews.text | string | Contenido del texto de la reseña. |
products.user_reviews.source | string | Plataforma de origen de la reseña. |
products.user_reviews.rating | int | Puntuación de la reseña del usuario. |
products.user_reviews.date | string | Fecha de la reseña. |
products.user_reviews.name | string | Nombre del revisor. |
products.user_reviews.title | string | Título de la reseña. |
share_url | string | Enlace para compartir. |