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ámetroTipoRequeridoDescripción
promptstringSíPrompt enviado a Google AI Overview.
countrystringSíCódigo del país o región.
shoppingbooleanNoIndica 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.
locationstringNoNombre 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.
uulestringNoCadena 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_linkbooleanNoObtener enlace para compartir.

Campos de respuesta

Nota: Cuando shopping está 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 content y rawtext estará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

typeproduct_positiondescripción
productrecomendadoproductos recomendados
productinline_linkproductos con enlaces en línea
productreferenciaproductos de referencia
producto de anunciosnullproductos de anuncios

Campo de datos Productos: productos patrocinados por Google

Campo de datos Anuncios: Google Ads (Serp)

ParámetroTipoDescripción
contentstringCuerpo 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.
rawtextstringDatos originales de la respuesta. Solo se rellena cuando se activa el modo de descripción general; de lo contrario, será una cadena vacía.
metadataobjectInformación de metadatos.
metadata.rawUrlstringURL de la página web.
is_overview_shoppingbooleanIndica si hay datos de compras integrados.
productsarrayDatos del producto.
products.deliverystringServicio de entrega.
products.discountstringInformación sobre descuentos.
products.imgstringURL de la imagen del producto.
products.orig_pricestringPrecio original.
products.ratingstringCalificación.
products.review_countstringNúmero de reseñas.
products.sellerstringVendedor.
products.urlstringURL de la página de detalles del producto.
products.storesarrayInformación de la tienda.
products.stores.delivery_feestringTarifa de envío.
products.stores.extensionsarrayServicios adicionales.
products.stores.linkstringEnlace de redirección del producto.
products.stores.namestringNombre de la tienda.
products.stores.pricestringPrecio de oferta.
products.ratingsstringCalificaciones.
products.tagstringEtiquetas.
products.titlestringTítulo del producto.
products.total_pricestringPrecio total.
sourcearrayFuentes de citas.
source.faviconstringFavicon del sitio web.
source.snippetstringExtracto del artículo citado.
source.thumbnailstringImagen de portada del artículo citado.
source.titlestringTítulo de la cita.
source.typestringTipo de fuente.
source.urlstringURL original de la cita.
source.website_namestringNombre del sitio web.
source.html_indexintIndica la posición de la tarjeta de compra del producto recomendado en el contenido Markdown.
source.storesarrayInformación de la tienda.
source.stores.delivery_feestringTarifa de envío.
source.stores.extensionsarrayServicios adicionales.
source.stores.linkstringEnlace de redirección del producto.
source.stores.namestringNombre de la tienda.
source.stores.pricestringPrecio de oferta.
web_sourcearrayFuentes de búsqueda web.
web_source.faviconstringFavicon del sitio web.
web_source.snippetstringExtracto del artículo citado.
web_source.thumbnailstringImagen de portada del artículo citado.
web_source.titlestringTítulo de la cita.
web_source.urlstringURL original de la cita.
web_source.website_namestringNombre del sitio web.
web_source.storesarrayInformación de la tienda.
web_source.stores.delivery_feestringTarifa de envío.
web_source.stores.extensionsarrayServicios adicionales.
web_source.stores.linkstringEnlace de redirección del producto.
web_source.stores.namestringNombre de la tienda.
web_source.stores.pricestringPrecio de oferta.
adsarrayAnuncios.
ads.section_titlestringTítulo de la sección.
ads.typestringTipo.
ads.titlestringTítulo.
ads.urlstringURL de la página web.
ads.google_ad_urlstringEnlace del anuncio.
ads.display_urlstringURL mostrada.
ads.advertiserstringAnunciante.
ads.descriptionstringDescripción.
ads.tracking_tokenstringToken de seguimiento.
ads.slotstringNúmero de ranura del anuncio.
ads.pricestringPrecio.
ads.orig_pricestringPrecio original.
ads.sellerstringVendedor.
ads.ratingstringCalificación.
ads.review_countstringNúmero de reseñas.
ads.imgstringURL de la imagen del producto.
ads.site_linksarrayEnlaces del sitio web.
ads.site_links.titlestringTítulo.
ads.site_links.urlstringURL de la página web.
ads.site_links.google_ad_urlstringEnlace del anuncio.
productsarrayInformación del producto devuelta por el modo de resumen de Google.
products.thumbnailsarrayMatriz de URLs de imágenes en miniatura del producto.
products.titlestringTítulo del producto.
products.urlstringURL de la página del producto.
products.brandstringNombre de la marca del producto.
products.reviewsintNúmero de reseñas.
products.ratingstringPuntuación media de valoración.
products.price_rangestringRango de precios, por ejemplo, $2,499.99.
products.storesarrayMatriz de ofertas de tiendas.
products.stores.namestringNombre de la tienda.
products.stores.linkstringEnlace al producto en la tienda.
products.stores.titlestringTítulo del producto en la tienda.
products.stores.ratingsstringCalificación de la tienda, por ejemplo, 4.3/5.
products.stores.extensionsarrayInformación adicional (disponibilidad, entrega, devoluciones).
products.stores.pricestringPrecio en la tienda.
products.stores.delivery_feestringInformación sobre la tarifa de envío.
products.stores.total_pricestringPrecio total incluyendo tarifas.
products.about_the_productobjectInformación detallada del producto.
products.about_the_product.titlestringTítulo de la sección.
products.about_the_product.linkstringEnlace a la página del producto.
products.about_the_product.displayed_linkstringNombre de dominio mostrado.
products.about_the_product.featuresarrayCaracterísticas/especificaciones del producto.
products.about_the_product.features.titlestringNombre de la característica.
products.about_the_product.features.valuestringValor de la característica.
products.about_the_product.descriptionstringDescripción del producto.
products.variantsarrayOpciones de variante del producto.
products.variants.titlestringTítulo de la categoría de variante.
products.variants.itemsarrayLista de opciones de variante.
products.variants.items.namestringNombre de la opción de variante.
products.variants.items.selectedboolIndica si esta variante está seleccionada.
products.variants.items.availabilityboolEstado de disponibilidad de la variante.
products.ratingsarrayDatos de distribución de calificaciones.
products.ratings.starsintNivel de calificación en estrellas (1-5).
products.ratings.amountintNúmero de calificaciones en este nivel.
products.user_reviewsarrayDatos de reseñas de usuarios.
products.user_reviews.textstringContenido del texto de la reseña.
products.user_reviews.sourcestringPlataforma de origen de la reseña.
products.user_reviews.ratingintPuntuación de la reseña del usuario.
products.user_reviews.datestringFecha de la reseña.
products.user_reviews.namestringNombre del revisor.
products.user_reviews.titlestringTítulo de la reseña.
share_urlstringEnlace para compartir.