# AI Overviews El `google_search` y `google_ads` las fuentes pueden devolver AI Overviews a partir de los resultados de Google Search en todas las regiones globales compatibles. `ai_overviews` el array de resultados admite varios bloques de IA 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 `mobile` | 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 IA pueden variar con el tiempo, incluso con parámetros idénticos. {% endhint %} {% hint style="success" %} Explora[ **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 principales países 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 de forma continua, con más países incluidos 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 # Updated payload. payload = { 'source': 'google_search', 'query': 'how to sell on amazon', 'render': 'html', 'user_agent_type': 'desktop', } # Get response. response = requests.request( 'POST', 'https://realtime.oxylabs.io/v1/queries', auth=('user', 'pass1'), json=payload, ) # Print prettified response to 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 sincrónico [**Realtime**](https://developers.oxylabs.io/documentation/es/soluciones-de-scraping/web-scraper-api/integration-methods/realtime) en nuestros ejemplos. Si deseas usar [**Proxy Endpoint**](https://developers.oxylabs.io/documentation/es/soluciones-de-scraping/web-scraper-api/integration-methods/proxy-endpoint) o la integración [**Push-Pull**](https://developers.oxylabs.io/documentation/es/soluciones-de-scraping/web-scraper-api/integration-methods/push-pull) asíncrona, consulta la sección de [**métodos de integración**](https://developers.oxylabs.io/documentation/es/soluciones-de-scraping/web-scraper-api/integration-methods) . ## 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
sourceDefine el scraper. Usa google_search o google_ads.google_search
queryLa palabra clave o frase que se va a buscar.-
renderHabilita el renderizado de JavaScript cuando se establece en html. Más información.-
context:
expand_aio		Establécelo en true para expandir Google AI Overviews (renderizado de JavaScript habilitado).false
parseDevuelve datos analizados cuando se establece en true.false
callback_urlURL a tu endpoint de callback. Más información.-
user_agent_typeTipo de dispositivo y navegador. Usa desktop o mobile.desktop
\- parámetro obligatorio #### Operadores de búsqueda avanzada 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 el ejemplo de consulta 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 a la que debe adaptarse el resultado. Usar correctamente este parámetro es extremadamente importante para obtener los datos correctos. Para más información, lee sobre nuestras geo_location estructuras de parámetros sugeridas 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.-
context:
results_language		Idioma de los resultados. La lista de idiomas de Google compatibles se puede encontrar aquí.
Aprende a usar los parámetros de contexto aquí.		-
### Paginación Controles para gestionar la paginación y la obtenció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 (cookie set). Al especificar los números de página en un array JSON con la clave page e 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 scroll continuo La Web Scraper API admite completamente el scroll continuo de Google Search. Detecta automáticamente diseños de desplazamiento continuo, cargando de forma eficiente los resultados orgánicos solicitados sin requerir parámetros adicionales. #### Límite por página {% hint style="warning" %} Debido a cambios recientes en el límite 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 array 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 (inclusive) 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 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 distintas pestañas de búsqueda, como imágenes, lugares o vídeos, 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 funciona como un contenedor para parámetros de Google más específicos, como limitar/ordenar los resultados por fecha, además de otros filtros, algunos de los cuales dependen del parámetro tbm p. ej. tbs=app_os:1 solo está disponible con el valor tbm de app. Más información aquí.-
{% hint style="warning" %} `udm` y `tbm` Los parámetros de contexto no se pueden usar juntos en una sola solicitud de extracción; selecciona solo uno. Usar ambos al mismo tiempo puede provocar conflictos o un comportamiento inesperado. {% endhint %} ### Otros Configuraciones y controles adicionales avanzados 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 parámetro render .-
context:
nfpr		true desactivará la autocorrección ortográficafalse
### Parámetros de contexto Todos los parámetros de contexto deben agregarse al array `context` como objetos con pares `key` y `de` , 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 tabla siguiente:
Clave (results.ai_overview)DescripciónTipo
answer_textInformación general sobre el término consultado en Google Search.array
bullet_listIndica información sobre 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 relevantes para la consulta de búsqueda.array
pos_overallUna indicación de la posición del resultado de la función SERP de AI Overviews entre todos los resultados SERP disponibles de Google.integer
### Trabajar con varios AI Overviews Como ahora los AI Overviews se devuelven como un array, debes iterar sobre ellos: {% tabs %} {% tab title="JavaScript" %} ```javascript // Processing all AI Overviews in a response response.results.ai_overviews.forEach((aiOverview, index) => { console.log(`Processing AI Overview #${index + 1}`); // Process individual components if (aiOverview.answer_text) { // Handle answer text } if (aiOverview.bullet_list) { // Handle bullet lists } // And so on... }); ``` {% endtab %} {% tab title="Python" %} ```python # Processing all AI Overviews in a response for index, ai_overview in enumerate(response['results']['ai_overviews']): print(f"Processing AI Overview #{index + 1}") # Process individual components if 'answer_text' in ai_overview: answer_texts = ai_overview['answer_text'] for answer in answer_texts: # Process each answer text if 'text' in answer: for text_item in answer['text']: print(f"Answer text: {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"List title: {bullet_list['list_title']}") if 'points' in bullet_list: for point in bullet_list['points']: print(f"- {point}") # Continue processing other elements... ``` {% endtab %} {% tab title="PHP" %} ```php $aiOverview) { $indexNumber = $index + 1; echo "Processing AI Overview #{$indexNumber}\n"; // Process answer text 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 "Answer text: {$textItem}\n"; } } } } // Process bullet lists if (isset($aiOverview['bullet_list']) && is_array($aiOverview['bullet_list'])) { foreach ($aiOverview['bullet_list'] as $bulletList) { if (isset($bulletList['list_title'])) { echo "List title: {$bulletList['list_title']}\n"; } if (isset($bulletList['points']) && is_array($bulletList['points'])) { foreach ($bulletList['points'] as $point) { echo "- {$point}\n"; } } } } // Continue processing other elements... } } ?> ``` {% 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 a continuación ejemplos de resultados de AI Overviews, 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.", "The Emporio Armani EA3192 is a pair of prescription glasses that are designed for men.", "Tienen una montura rectangular hecha de plástico ligero e hipoalergénico.", "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 gratuita", "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 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 producto 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": "This simple recipe features a homemade crust, Granny Smith apples, and warm spices.", "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 en 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 AI Overviews Info.integer
### Instrucción En el siguiente ejemplo, se usó la consulta "docker exec commands explained".
```json ... "ai_overviews": [ { "answer_text": [ { "text": [ "The docker execExecIn computing, 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 un ordenador o software para realizar una tarea específica.string