# AI Overviews 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. {% hint style="danger" %} 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. {% endhint %} {% hint style="success" %} Explorar[ **diccionario de datos**](#data-dictionary) para algunas de las funciones SERP de AI Overviews. {% endhint %} ## 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 {% hint style="warning" %} La función Google AI Overviews se está implementando continuamente y se van incluyendo más países con el tiempo. {% endhint %} ## Ejemplos de solicitud {% tabs %} {% tab title="cURL" %} ```shell 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 }' ``` {% endtab %} {% tab title="Python" %} ```python import requests from pprint import pprint # Carga útil actualizada. payload = { 'source': 'google_search', 'query': 'how to sell on amazon', 'render': 'html', 'user_agent_type': 'desktop', } # Obtén la respuesta. response = requests.request( 'POST', 'https://realtime.oxylabs.io/v1/queries', auth=('user', 'pass1'), json=payload, ) # Imprime la respuesta con formato en stdout. pprint(response.json()) ``` {% endtab %} {% tab title="PHP" %} ```php 'google_search', 'query' => 'how to sell on amazon', 'render' => 'html', 'user_agent_type' => 'desktop', ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params)); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_USERPWD, "user" . ":" . "pass1"); $headers = []; $headers[] = "Content-Type: application/json"; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); echo $result; if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch); ``` {% endtab %} {% tab title="HTTP" %} ```http https://realtime.oxylabs.io/v1/queries?source=google_search&query=Emporio%20Armani%20EA3192&render=html&user_agent_type=desktop&access_token=12345abcde ``` {% endtab %} {% tab title="JSON" %} ```json { "source": "google_search", "query": "how to sell on amazon", "render": "html", "user_agent_type": "desktop" } ``` {% endtab %} {% endtabs %} Usamos el método de integración síncrona [**Realtime**](/products/es/web-scraper-api/integration-methods/realtime.md) en nuestros ejemplos. Si deseas usar [**Proxy Endpoint**](/products/es/web-scraper-api/integration-methods/proxy-endpoint.md) o la integración asíncrona [**Push-Pull**](/products/es/web-scraper-api/integration-methods/push-pull.md) consulta la sección de [**métodos de integración**](/products/es/web-scraper-api/integration-methods.md) . ## 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ámetroDescripciónValor predeterminado
sourceEstablece el scraper. Usa google_search o google_ads.google_search
queryLa palabra clave o frase a buscar.-
renderHabilita 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
parseDevuelve datos analizados cuando se establece en true.false
callback_urlURL de tu endpoint de callback. Más información-
user_agent_typeTipo 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í**](https://ahrefs.com/blog/google-advanced-search-operators/) y [**aquí**](https://www.semrush.com/kb/831-how-to-use-google-advanced-search-operators). Consulta la consulta de ejemplo a continuación. ```json { "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ámetroDescripciónValor predeterminado
geo_locationLa 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í.-
localeAccept-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ámetroDescripciónValor predeterminado
start_pageNúmero de página inicial.1
pagesNúmero de páginas a recuperar.1
limitNúmero de resultados a recuperar en cada página.10
context:limit_per_pageExtrae 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 {% hint style="warning" %} 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. {% endhint %} Para usar esta función, incluye un arreglo JSON con objetos JSON que contengan los siguientes datos:
ParámetroDescripciónEjemplo
pageEl número de la página que deseas extraer. Cualquier valor entero mayor que 0 funcionará1
limitEl número de resultados en la página en cuestión. Cualquier valor entero entre 1 y 100 (incluido) funcionará.90
#### Ejemplo de solicitud ```json { "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í**](#context-parameters).
ParámetroDescripciónValor 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í.-
{% hint style="warning" %} `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. {% endhint %} ### Otros Configuraciones y controles avanzados adicionales para requisitos especializados.
ParámetroDescripciónValor 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áficafalse
### 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.: ```json ... "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ónTipo
answer_textInformación general sobre el término de consulta de Google Search.array
bullet_listIndica información sobre los elementos renderizados en una lista con viñetas dentro de la función SERP de AI Overviews.array
productsUna lista de productos con sus respectivos detalles.object
source_panelUna lista de fuentes usadas para generar el resultado de AI Overviews en la función SERP de Google.object
additional_questionsUna lista de preguntas adicionales con sus respectivos detalles.object
recipesUna lista de recetas con sus respectivos detalles.object
info_listUna lista de información usada con mayor frecuencia para representar pasos de un proceso relacionados con la consulta de búsqueda.array
pos_overallUn 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: {% tabs %} {% tab title="JavaScript" %} ```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... }); ``` {% endtab %} {% tab title="Python" %} ```python # Procesando todos los AI Overviews en una respuesta for index, ai_overview in enumerate(response['results']['ai_overviews']): print(f"Procesando AI Overview #{index + 1}") # Procesar componentes individuales if 'answer_text' in ai_overview: answer_texts = ai_overview['answer_text'] for answer in answer_texts: # Procesar cada texto de respuesta if 'text' in answer: for text_item in answer['text']: print(f"Texto de respuesta: {text_item}") if 'bullet_list' in ai_overview: bullet_lists = ai_overview['bullet_list'] for bullet_list in bullet_lists: if 'list_title' in bullet_list: print(f"Título de la lista: {bullet_list['list_title']}") if 'points' in bullet_list: for point in bullet_list['points']: print(f"- {point}") # Continuar procesando otros elementos... ``` {% endtab %} {% tab title="PHP" %} ```php $aiOverview) { $indexNumber = $index + 1; echo "Procesando AI Overview #{$indexNumber}\n"; // Procesar el texto de respuesta if (isset($aiOverview['answer_text']) && is_array($aiOverview['answer_text'])) { foreach ($aiOverview['answer_text'] as $answer) { if (isset($answer['text']) && is_array($answer['text'])) { foreach ($answer['text'] as $textItem) { echo "Texto de respuesta: {$textItem}\n"; } } } } // Procesar listas con viñetas if (isset($aiOverview['bullet_list']) && is_array($aiOverview['bullet_list'])) { foreach ($aiOverview['bullet_list'] as $bulletList) { if (isset($bulletList['list_title'])) { echo "Título de la lista: {$bulletList['list_title']}\n"; } if (isset($bulletList['points']) && is_array($bulletList['points'])) { foreach ($bulletList['points'] as $point) { echo "- {$point}\n"; } } } } // Continuar procesando otros elementos... } } ?> ``` {% endtab %} {% endtabs %} 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**](#item), [**Recetas**](#recipe), [**Instrucción**](#instruction). ### Elemento En el siguiente ejemplo, se usó la consulta "Emporio Armani EA3192".
```json ... "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ónTipo
textUna respuesta breve a la consulta de Google Search.array
posUn 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ónTipo
list_titleEl título de la lista con viñetas.string
pointsLos elementos renderizados en la lista con viñetas. Todos los elementos están separados por comas.array
posUn 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ónTipo
itemsUna lista de productos con sus respectivos detalles.array
items.product_nameEl nombre del producto.string
items.priceEl precio actual del producto.string
items.previous_priceEl precio inicial del producto (si aplica).string
items.sellerEl vendedor del producto.string
items.shippingEl tipo de envío disponible para el producto.string
items.urlLa URL del producto.string
items.posUn 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ónTipo
itemsUna lista de fuentes usadas para generar el resultado de AI Overviews en la función SERP de Google.object
items.urlLa URL del sitio web.string
items.sourceEl nombre del sitio web.string
items.dateLa fecha en que se publicó el artículo.string
items.titleEl título del artículo.string
items.posUn 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ónTipo
items.questionUna lista de preguntas adicionales relevantes para la consulta de búsqueda original, separadas por comas.array
items.posUn 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".
```json ... "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ónTipo
itemsUna lista de recetas con sus respectivos detalles.array
items.descriptionUna breve descripción de la receta.string
items.imageUna imagen miniatura de la receta codificada en base64.string
items.sourceEl nombre del sitio donde se publica la receta.string
items.ratingLa calificación de la receta.string
items.rating_countEl número de valoraciones.string
items.durationEl tiempo necesario para preparar el plato.string
items.urlLa URL de la receta completa.string
items.titleEl 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ónTipo
list_titleEl título de la lista.string
list_itemsContiene una lista de elementos con sus respectivos detalles.array
list_items.titleEl título de la sección dentro de la lista.string
list_items.contentUna breve descripción de la sección.array
list_item.posUn 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".
```json ... "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** {% hint style="info" %} Nota: los detalles se renderizan en el mismo array que para [**consulta de búsqueda relacionada con el elemento**](#answer-text), sin embargo, aparece un nuevo tipo de clave (command) para el tipo de consulta relacionado con instrucciones {% endhint %}
Clave (results.ai_overviews.answer_text)DescripciónTipo
commandUna instrucción dada a una computadora o software para realizar una tarea específica.string
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.oxylabs.io/api-targets/es/motores-de-busqueda/google/ai-overviews.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.