AI Overviews

Extrae Google AI Overviews de los resultados de búsqueda con datos analizados para el texto de respuesta, listas con viñetas, productos, recetas, paneles de origen, listas de información y preguntas adicionales.

El google_search y google_ads las fuentes pueden devolver AI Overviews de los resultados de Google Search en todas las regiones globales compatibles. ai_overviews el array de resultados admite varios bloques de AI en una sola respuesta, incluidas secciones como “People also ask” y “Things to know.”

Para maximizar la posibilidad de recibir contenido de AI Overviews completamente renderizado, debes incluir los siguientes parámetros:

Parámetro	Valor
source	google_search o google_ads
render	html
user_agent_type	desktop o móvil

Usar estos parámetros también te permite recibir tanto la respuesta general como el contenido de AI Overviews con una sola solicitud.

Google genera este contenido dinámicamente o carga una versión en caché, por lo que las respuestas generadas por AI pueden variar con el tiempo, incluso con parámetros idénticos.

Explorar diccionario de datos para algunas de las funciones SERP de AI Overviews.

Disponibilidad regional de AI Overviews

Google AI Overviews está disponible en la mayoría de los países, con algunas excepciones. Actualmente, los países más grandes excluidos son:

• Francia

• Mónaco

• China

• Irán

• Sudán

• Siria

• Cuba

• Corea del Norte

La función Google AI Overviews se está implementando continuamente y se van incluyendo más países con el tiempo.

Ejemplos de solicitud

cURL

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "query": "how to sell on amazon",
        "render": "html",
        "user_agent_type": "desktop",
        "parse": true
        
    }'

Python

PHP

HTTP

JSON

Usamos el método de integración síncrona Realtime en nuestros ejemplos. Si deseas usar Proxy Endpoint o la integración asíncrona Push-Pull consulta la sección de métodos de integración .

Valores de los parámetros de solicitud

Genérico

Configuración básica y opciones de personalización para extraer resultados de Google Web search con AI Overviews.

Parámetro	Descripción	Valor predeterminado
source	Establece el scraper. Usa google_search o google_ads.	google_search
query	La palabra clave o frase a buscar.	-
render	Habilita el renderizado de JavaScript cuando se establece en html. Más información.	-
context: expand_aio	Establecer en true para expandir Google AI Overviews (renderizado de JavaScript habilitado).	false
parse	Devuelve datos analizados cuando se establece en true.	false
callback_url	URL de tu endpoint de callback. Más información	-
user_agent_type	Tipo de dispositivo y navegador. Usa desktop o móvil.	desktop

- parámetro obligatorio

Operadores avanzados de búsqueda de Google

Al extraer datos, puede resultarte útil combinar operadores avanzados de búsqueda de Google con tu consulta. Esto te permite personalizar el alcance de la búsqueda, asegurando que los resultados sean más relevantes y específicos. Explora estos comandos especiales aquí y aquí. Consulta la consulta de ejemplo a continuación.

{
    "source": "google_search",
    "query": "iphone 15 launch inurl:apple", 
    "render": "html",
    "user_agent_type": "desktop"
}

Localización

Adapta los resultados de búsqueda a ubicaciones geográficas e idiomas específicos.

Parámetro	Descripción	Valor predeterminado
geo_location	La ubicación geográfica para la que se debe adaptar el resultado. Usar este parámetro correctamente es extremadamente importante para obtener los datos correctos. Para más información, lee sobre nuestras geo_location estructuras de parámetros aquí.	-
locale	Accept-Language valor del encabezado que cambia el idioma de la interfaz web de tu página de búsqueda de Google. Más información.	-

Paginación

Controles para gestionar la paginación y la recuperación de resultados de búsqueda.

Parámetro	Descripción	Valor predeterminado
start_page	Número de página inicial.	1
pages	Número de páginas a recuperar.	1
limit	Número de resultados a recuperar en cada página.	10
context:limit_per_page	Extrae varias páginas usando la misma dirección IP y sesión (conjunto de cookie). Al especificar los números de página en un arreglo JSON con la clave page y al indicar el número de resultados orgánicos por página usando la clave limit puedes minimizar la posibilidad de ver resultados orgánicos superpuestos entre páginas (por ejemplo, que el último resultado orgánico de la primera página sea el mismo que el primer resultado orgánico de la segunda página). Ver ejemplo.	-

Compatibilidad con desplazamiento continuo

La Web Scraper API admite completamente el desplazamiento continuo de Google Search. Detecta automáticamente diseños de desplazamiento continuo y carga de forma eficiente los resultados orgánicos solicitados sin necesidad de parámetros adicionales.

Límite por página

Debido a cambios recientes en los límites de Google, hemos ajustado el comportamiento de Web Scraper API. El máximo de resultados por página coincidirá con la salida orgánica de Google, que normalmente es de 10 resultados.

Para usar esta función, incluye un arreglo JSON con objetos JSON que contengan los siguientes datos:

Parámetro	Descripción	Ejemplo
page	El número de la página que deseas extraer. Cualquier valor entero mayor que 0 funcionará	1
limit	El número de resultados en la página en cuestión. Cualquier valor entero entre 1 y 100 (incluido) funcionará.	90

Ejemplo de solicitud

{
    "source": "google_search",
    "query": "how to sell on amazon",
    "render": "html",
    "user_agent_type": "dekstop",
    "parse": true,
    "context": [
        {
            "key": "limit_per_page",
            "value": [
                {"page": 1, "limit": 10},
                {"page": 2, "limit": 90}
                    ]
        }]
}

Filtrado

Opciones para filtrar y refinar los resultados de búsqueda según varios criterios. Aprende a usar los parámetros de contexto aquí.

Parámetro	Descripción	Valor predeterminado
context: filter	Establecer el valor de este parámetro en 0 te permite ver resultados que de otro modo se excluirían debido a su similitud con otros resultados.	1
context: safe_search	Búsqueda segura. Establécelo en true para habilitarla.	false
context: udm	udm el parámetro permite cambiar entre diferentes pestañas de búsqueda, como imágenes, lugares o videos, para personalizar el tipo de resultados mostrados. Encuentra los valores aceptados aquí.	-
context: tbm	To-be-matched o tbm parámetro. Los valores aceptados son: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl	-
context: tbs	Este parámetro es como un contenedor para parámetros menos comunes de Google, como limitar/ordenar resultados por fecha y otros filtros, algunos de los cuales dependen de la tbm (p. ej. tbs=app_os:1 solo está disponible con el tbm valor app). Más información aquí.	-

udm y tbm los parámetros de contexto no pueden usarse juntos en una sola solicitud de scraping; selecciona solo uno. Usar ambos simultáneamente puede provocar conflictos o comportamientos inesperados.

Otros

Configuraciones y controles avanzados adicionales para requisitos especializados.

Parámetro	Descripción	Valor predeterminado
context: fpstate	Establecer el valor de fpstate en aig hará que Google cargue más aplicaciones. Este parámetro solo es útil si se usa junto con el render parámetro.	-
context: nfpr	true desactivará la autocorrección ortográfica	false

Parámetros de contexto

Todos los parámetros de contexto deben añadirse al arreglo context como objetos con pares key y valor value, por ejemplo.:

...
"context": [
    {
        "key": "filter",
        "value": "0"
    }
]
...

Estructura y procesamiento de datos

Diccionario de datos

Todas las claves disponibles dentro de la función SERP de AI Overviews se definen en la siguiente tabla:

Clave (results.ai_overview)	Descripción	Tipo
answer_text	Información general sobre el término de consulta de Google Search.	array
bullet_list	Indica información sobre los elementos renderizados en una lista con viñetas dentro de la función SERP de AI Overviews.	array
products	Una lista de productos con sus respectivos detalles.	object
source_panel	Una lista de fuentes usadas para generar el resultado de AI Overviews en la función SERP de Google.	object
additional_questions	Una lista de preguntas adicionales con sus respectivos detalles.	object
recipes	Una lista de recetas con sus respectivos detalles.	object
info_list	Una lista de información usada con mayor frecuencia para representar pasos de un proceso relacionados con la consulta de búsqueda.	array
pos_overall	Un indicador que denota la posición del resultado de la función SERP de AI Overviews entre todos los resultados disponibles de Google SERP.	integer

Trabajar con múltiples AI Overviews

Como AI Overviews ahora se devuelven como un array, debes iterar sobre ellos:

JavaScript

// Procesando todos los AI Overviews en una respuesta
response.results.ai_overviews.forEach((aiOverview, index) => {
  console.log(`Procesando AI Overview #${index + 1}`);
  // Procesar componentes individuales
  if (aiOverview.answer_text) {
    // Manejar el texto de respuesta
  }
  if (aiOverview.bullet_list) {
    // Manejar listas con viñetas
  }
  // Y así sucesivamente...
});

Python

PHP

En la mayoría de los casos, solo habrá un AI Overview, pero tu código debe estar preparado para manejar varias entradas.

Explora ejemplos de resultados de AI Overviews a continuación, categorizados por diferentes consultas de búsqueda: Elemento, Recetas, Instrucción.

Elemento

En el siguiente ejemplo, se usó la consulta "Emporio Armani EA3192".

...
  "ai_overviews": [
    {
      "answer_text": [
        {
          "text": [
            "Emporio Armani es una marca de lujo conocida por sus diseños atemporales y su compromiso con la artesanía italiana.",
            "Las Emporio Armani EA3192 son unas gafas graduadas diseñadas para hombres.",
            "Tienen una montura rectangular hecha de plástico hipoalergénico y ligero.",
            "Las lentes son UV y antirreflectantes.",
            "Aquí hay algunas ideas de las reseñas:"
          ],
          "pos": 1
        }
      ],
      "bullet_list": [
        {
          "list_title": "Pros",
          "points": [
            "Cómodas",
            "Marca mínima"
          ],
          "pos": 1
        }
      ],
      "products": {
        "items": [
          {
            "product_name": "Emporio Armani Men Eyeglasses Shiny Black Size: 53",
            "price": "$163.00",
            "previous_price": null,
            "seller": "Lenscrafters",
            "shipping": "Entrega gratis",
            "url": "https://www.lenscrafters.com/lc-us/emporio-armani/8056597975810?srsltid=AfmBOoqWO55KIJevhQp_c5OAp0JOM_8Uza3_gCvn9S4x4Vz342AUSQewzJI",
            "pos": 1
          }
        ]
      },
      "source_panel": {
        "items": [
          {
            "url": "https://www.italist.com/magazine/what-is-emporio-armani/#:~:text=Emporio%20Armani%20is%20a%20luxury,reinforce%20the%20perception%20of%20luxury.",
            "source": "italist.com",
            "date": "May 5, 2023",
            "title": "What is Emporio Armani and is Emporio Armani a luxury brand?",
            "pos": 1
          },
        ...
        ]
      },
      "additional_questions": {
        "items": [
          {
           "question": "Is Emporio Armani the same as Giorgio Armani?",
           "pos": 1
          }
        ]
      },
      "pos_overall": 1
    }
  ],
...

Texto de respuesta

Clave (results.ai_overviews.answer_text)	Descripción	Tipo
text	Una respuesta breve a la consulta de Google Search.	array
pos	Un indicador que denota la posición de un elemento dado entre todos los resultados de respuesta de AI Overviews.	integer

Lista con viñetas

Clave (results.ai_overviews.bullet_list)	Descripción	Tipo
list_title	El título de la lista con viñetas.	string
points	Los elementos renderizados en la lista con viñetas. Todos los elementos están separados por comas.	array
pos	Un indicador que denota la posición de un elemento dado entre todos los resultados de la lista con viñetas de AI Overviews.	integer

Productos

Clave (results.ai_overviews.products)	Descripción	Tipo
items	Una lista de productos con sus respectivos detalles.	array
items.product_name	El nombre del producto.	string
items.price	El precio actual del producto.	string
items.previous_price	El precio inicial del producto (si aplica).	string
items.seller	El vendedor del producto.	string
items.shipping	El tipo de envío disponible para el producto.	string
items.url	La URL del producto.	string
items.pos	Un indicador que denota la posición de un elemento dado entre todos los resultados de productos de AI Overviews.	integer

Panel de fuentes

Clave (results.ai_overviews.source_panel)	Descripción	Tipo
items	Una lista de fuentes usadas para generar el resultado de AI Overviews en la función SERP de Google.	object
items.url	La URL del sitio web.	string
items.source	El nombre del sitio web.	string
items.date	La fecha en que se publicó el artículo.	string
items.title	El título del artículo.	string
items.pos	Un indicador que denota la posición de un elemento dado entre todos los resultados del panel de fuentes de AI Overviews.	integer

Preguntas adicionales

Clave (results.ai_overviews.additional_questions)	Descripción	Tipo
items.question	Una lista de preguntas adicionales relevantes para la consulta de búsqueda original, separadas por comas.	array
items.pos	Un indicador que denota la posición de un elemento dado entre todos los resultados de preguntas adicionales de AI Overviews.	integer

Receta

En el siguiente ejemplo, se usó la consulta "recipe for an apple pie".

...  
 "ai_overviews": [
   {
      "recipes": {
        "items": [
          {
            "description": "Esta receta sencilla incluye una base casera, manzanas Granny Smith y especias cálidas.",
            "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/...",
            "source": "Allrecipes",
            "rating": "4.8",
            "rating_count": "13K",
            "duration": "90 min",
            "url": "https://www.allrecipes.com/recipe/12682/apple-pie-by-grandma-ople/",
            "title": "Apple Pie by Grandma Ople"
          },
...
        ]
      }
    }
  ],
...

Recetas

Clave (results.ai_overviews.recipes)	Descripción	Tipo
items	Una lista de recetas con sus respectivos detalles.	array
items.description	Una breve descripción de la receta.	string
items.image	Una imagen miniatura de la receta codificada en base64.	string
items.source	El nombre del sitio donde se publica la receta.	string
items.rating	La calificación de la receta.	string
items.rating_count	El número de valoraciones.	string
items.duration	El tiempo necesario para preparar el plato.	string
items.url	La URL de la receta completa.	string
items.title	El título de la receta.	string

En el siguiente ejemplo, se usó la consulta "recipe of a juicy succulent steak".

Lista de información

Clave (results.ai_overviews.info_list)	Descripción	Tipo
list_title	El título de la lista.	string
list_items	Contiene una lista de elementos con sus respectivos detalles.	array
list_items.title	El título de la sección dentro de la lista.	string
list_items.content	Una breve descripción de la sección.	array
list_item.pos	Un indicador que denota la posición de un elemento dado entre todos los resultados de la lista de información de AI Overviews.	integer

Instrucción

En el siguiente ejemplo, se usó la consulta "docker exec commands explained".

...
  "ai_overviews": [
    {
      "answer_text": [
        {
          "text": [
            "El docker execExecEn informática, exec es una funcionalidad de un sistema operativo que ejecuta un archivo ejecutable en el contexto de un proceso ya existente, reemplazando el ejecutable anterior...",
            "Es una herramienta poderosa que puede usarse para una variedad de tareas, como solucionar problemas de un contenedor, ejecutar un script o instalar software."
          ],
          "pos": 1
        },
        {
          "text": [
            "La sintaxis del comando docker exec es la siguiente:"
          ],
          "command": [
            "docker exec [OPTIONS] CONTAINER COMMAND [ARG...]"
          ],
          "pos": 2
        },
        ...
        }
      ]
    }
  ],
...

Comando de texto de respuesta

Nota: los detalles se renderizan en el mismo array que para consulta de búsqueda relacionada con el elemento, sin embargo, aparece un nuevo tipo de clave (command) para el tipo de consulta relacionado con instrucciones

Clave (results.ai_overviews.answer_text)	Descripción	Tipo
command	Una instrucción dada a una computadora o software para realizar una tarea específica.	string