AI Overviews

Aprende cómo puedes extraer AI Overviews con Web Scraper API. Encuentra ejemplos de código y parámetros soportados.

El google_search y google_ads las fuentes pueden devolver AI Overviews desde los resultados de Google Search en todas las regiones globales compatibles. ai_overviews la matriz de resultados admite múltiples bloques de IA en una sola respuesta, incluidas secciones como “People also ask” y “Things to know”.

Para maximizar la probabilidad de recibir contenido de AI Overviews completamente renderizado, debe 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 le permite recibir tanto la respuesta general como el contenido de AI Overviews con una sola solicitud.

Google genera dinámicamente este contenido 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.

Explorar diccionario de datos para algunas de las características 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 excluidos más grandes son:

Francia
China
Irán
Corea del Norte

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

Muestras de solicitud

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
        
    }'

import requests
from pprint import pprint

# Payload actualizado.
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())

<?php

$params = [
    'source' => '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);

Usamos Realtime método de integración en nuestros ejemplos. Si desea usar Proxy Endpoint o asincrónico Push-Pull integración, consulte el métodos de integración sección.

Valores de parámetros de la solicitud

Genérico

Configuración básica y opciones de personalización para raspar resultados de búsqueda web de Google con AI Overviews.

Parámetro

Descripción

Valor predeterminado

source

Establece el scraper. Use google_search o google_ads.

google_search

query

La palabra clave o frase para buscar.

render

Activa el renderizado de JavaScript cuando se establece en html. Más información.

parse

Devuelve datos analizados cuando se establece en true.

false

callback_url

URL de su endpoint de callback. Más información.

user_agent_type

Tipo de dispositivo y navegador. Use desktop o móvil.

desktop

- parámetro obligatorio

Operadores de búsqueda avanzada de Google

Al raspar, puede resultar útil combinar operadores avanzados de búsqueda de Google con su consulta. Le permite personalizar el alcance de la búsqueda, asegurando que los resultados sean más relevantes y centrados. Explore estos comandos especiales aquí y aquí. Vea la consulta de ejemplo a continuación.

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

Localización

Adapte 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 cual se deben adaptar los resultados. Usar este parámetro correctamente es extremadamente importante para obtener los datos correctos. Para más información, lea sobre nuestras sugeridas geo_location estructuras de parámetros aquí.

locale

Accept-Language valor del encabezado que cambia el idioma de la interfaz web de la página de búsqueda de Google. Más información.

context: results_language

Idioma de los resultados. La lista de idiomas de Google soportados se puede encontrar aquíIdioma de los resultados. La lista de idiomas de Google compatibles se puede encontrar aquí.

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:Número de resultados a recuperar en cada página.

limit_per_page Raspe múltiples páginas usando la misma dirección IP y sesión (conjunto de cookies). Al especificar los números de página en un array JSON con la page limit clave e indicando el número de resultados orgánicos por página usando la clave, puede minimizar la posibilidad de ver resultados orgánicos superpuestos entre páginas (p. ej., el último resultado orgánico de la primera página siendo el mismo que el primer resultado orgánico de la segunda página)..

Ver ejemplo

La Web Scraper API admite completamente el desplazamiento continuo de Google Search. Detecta automáticamente los diseños de desplazamiento continuo, cargando de manera eficiente los resultados orgánicos solicitados sin parámetros adicionales requeridos.

La Web Scraper API admite completamente el desplazamiento continuo de Google Search. Detecta automáticamente los diseños de desplazamiento continuo, cargando eficientemente los resultados orgánicos solicitados sin parámetros adicionales requeridos.

Límite por página

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

Parámetro

Descripción

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

Raspe múltiples páginas usando la misma dirección IP y sesión (conjunto de cookies). Al especificar los números de página en un array JSON con la

Ejemplo 0 El número de la página que desea raspar. Cualquier valor entero mayor que

1

limit

funcionará 1 y 100 El número de resultados en la página en cuestión. Cualquier valor entero entre

90

(inclusive) funcionará.

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

{"page": 2, "limit": 90}

Filtrado aquí.

Parámetro

Descripción

Valor predeterminado

context: Opciones para filtrar y refinar los resultados de búsqueda según varios criterios. Aprenda a usar parámetros de contexto

filter 0 Establecer el valor de este parámetro en

1

context: le permite ver resultados que de otro modo serían excluidos debido a su similitud con otros resultados.

safe_search true Búsqueda segura. Establecer en

false

context: para activarla.

para activarla. udm aquí.

context: 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. Encuentre los valores aceptados

tbm 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. Encuentre los valores aceptados Parámetro To-be-matched o . Los valores aceptados son:, app, blg, bks, dsc, isch, nws, pts, plcs, rcp

context: lcl

Este parámetro es como un contenedor para parámetros de Google más oscuros, como limitar/ordenar resultados por fecha, así como otros filtros, algunos de los cuales dependen del 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. Encuentre los valores aceptados Este parámetro es como un contenedor para parámetros de Google más oscuros, como limitar/ordenar resultados por fecha, así como otros filtros, algunos de los cuales dependen del parámetro (p. ej. tbs=app_os:1 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. Encuentre los valores aceptados value . Los valores aceptados son:value aquí.

para activarla. y 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. Encuentre los valores aceptados ). Más información

Otros

Ajustes avanzados adicionales y controles para requisitos especializados.

Parámetro

Descripción

Valor predeterminado

context: Configuraciones y controles avanzados adicionales para requisitos especializados.

fpstate Configuraciones y controles avanzados adicionales para requisitos especializados. Establecer el valor en aig render hará que Google cargue más aplicaciones. Este parámetro solo es útil si se usa junto con el

context: nfpr

true desactivará la autocorrección ortográfica

false

Parámetros de contexto

Todos los parámetros de contexto deben añadirse al context array como objetos con key y value pares, p. ej.:

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

Estructura y procesamiento de datos

Diccionario de datos

Todas las claves disponibles dentro de la función SERP AI Overviews están definidas en la tabla a continuación:

Clave (results.ai_overview)

Descripción

Tipo

answer_text

Información general sobre el término de búsqueda de Google Search.

array

bullet_list

Indica información sobre elementos renderizados en una lista con viñetas dentro de la función SERP AI Overviews.

array

products

Una lista de productos con sus respectivos detalles.

object

source_panel

Una lista de fuentes utilizadas para generar el resultado 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 detalles respectivos.

object

info_list

Una lista de información frecuentemente usada para representar pasos de un proceso relevante para la consulta de búsqueda.

array

pos_overall

Una indicación de la posición del resultado de la función SERP AI Overviews entre todos los resultados disponibles en Google SERP.

integer

Trabajar con múltiples AI Overviews

Dado que AI Overviews ahora se devuelve como una matriz, debe iterar a través de ellas:

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

# Procesando todos los AI Overviews en una respuesta
for index, ai_overview in enumerate(response['results']['ai_overviews']):
    print(f"Processing 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"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}")
    # Continuar procesando otros elementos...

<?php
// Procesando todos los AI Overviews en una respuesta
if (isset($response['results']['ai_overviews']) && is_array($response['results']['ai_overviews'])) {
    foreach ($response['results']['ai_overviews'] as $index => $aiOverview) {
        $indexNumber = $index + 1;
        echo "Processing AI Overview #{$indexNumber}\n";
        
        // Procesar 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 "Answer text: {$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 "List title: {$bulletList['list_title']}\n";
                }
                if (isset($bulletList['points']) && is_array($bulletList['points'])) {
                    foreach ($bulletList['points'] as $point) {
                        echo "- {$point}\n";
                    }
                }
            }
        }
        // Continuar procesando otros elementos...
    }
}
?>

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

Explore ejemplos de resultados de AI Overviews a continuación, categorizados por diferentes consultas de búsqueda: Ítem, Recipes, Instrucción.

Ítem

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.",
            "El Emporio Armani EA3192 es un par de gafas graduadas diseñadas para hombres.",
            "Tienen una montura rectangular hecha de plástico hipoalergénico y ligero.",
            "Las lentes son UV y anti-reflectantes.",
            "Aquí hay algunos puntos destacados de las reseñas:"
          ],
          "pos": 1
        }
      ],
      "bullet_list": [
        {
          "list_title": "Pros",
          "points": [
            "Cómodas",
            "Marca mínima"
          ],
          "pos": 1
        }
      ],
      "products": {
        "results": {
          {
            "product_name": "Gafas de hombre Emporio Armani Negro brillante Talla: 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": {
        "results": {
          {
            "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": {
        "results": {
          {
           "question": "Is Emporio Armani the same as Giorgio Armani?",
           "pos": 1
          }
        ]
      },
      "url_image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSTCgTZ1im_6ZX9YSCrjQfjVEnTmpmiqqYAHAhXzA9VhJdrokOeOnWsbEOxqA8zPkaos192xPF5ogA&usqp=CAc",
    }
  ],
...

Texto de la respuesta

Clave (results.ai_overviews.answer_text)

Descripción

Tipo

texto

Una respuesta corta 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 mostrados 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 listas con viñetas de AI Overviews.

integer

Productos

Clave (results.ai_overviews.products)

Descripción

Tipo

elementos

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 fuente

Clave (results.ai_overviews.source_panel)

Descripción

Tipo

elementos

Una lista de fuentes utilizadas para generar el resultado 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 separadas por comas relevantes para la consulta de búsqueda original.

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": {
        "results": {
          {
            "description": "Esta receta simple incluye una masa 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"
          },
...
        ]
      }
    }
  ],
...

Recipes

Clave (results.ai_overviews.recipes)

Descripción

Tipo

elementos

Una lista de recetas con sus detalles respectivos.

array

items.description

Una breve descripción de la receta.

string

items.image

Una imagen en 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 a 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 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": [
            "The docker execExecIn computing, exec is a functionality of an operating system that runs an executable file in the context of an already existing process, replacing the previous executable...",
            "It is a powerful tool that can be used for a variety of tasks, such as troubleshooting a container, running a script, or installing software."
          ],
          "pos": 1
        },
        {
          "text": [
            "The syntax for the docker exec command is as follows:"
          ],
          "command": [
            "docker exec [OPTIONS] CONTAINER COMMAND [ARG...]"
          ],
          "pos": 2
        },
        ...
        }
      ]
    }
  ],
...

Comando de texto de respuesta

Nota: los detalles se muestran en la misma matriz que para consulta de búsqueda relacionada con el ítem, sin embargo, aparece un nuevo tipo de clave (command) para consultas relacionadas 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

AnteriorModo AI SiguienteAds Max

Última actualización hace 1 día

¿Te fue útil?

Buenas noches

hashtagDisponibilidad regional de AI Overviews

hashtagMuestras de solicitud

hashtagValores de parámetros de la solicitud

hashtagGenérico

hashtagOperadores de búsqueda avanzada de Google

hashtagLocalización

hashtagPaginación

hashtagVer ejemplo

hashtagLa Web Scraper API admite completamente el desplazamiento continuo de Google Search. Detecta automáticamente los diseños de desplazamiento continuo, cargando eficientemente los resultados orgánicos solicitados sin parámetros adicionales requeridos.

hashtag(inclusive) funcionará.

hashtag{"page": 2, "limit": 90}

hashtagOtros

hashtagParámetros de contexto

hashtagEstructura y procesamiento de datos

hashtagDiccionario de datos

hashtagTrabajar con múltiples AI Overviews

hashtagÍtem

hashtagTexto de la respuesta

hashtagPanel de fuente

hashtagPreguntas adicionales

hashtagReceta

hashtagLista de información

hashtagInstrucción

Disponibilidad regional de AI Overviews

Muestras de solicitud

Valores de parámetros de la solicitud

Genérico

Operadores de búsqueda avanzada de Google

Localización

Paginación

Ver ejemplo

La Web Scraper API admite completamente el desplazamiento continuo de Google Search. Detecta automáticamente los diseños de desplazamiento continuo, cargando eficientemente los resultados orgánicos solicitados sin parámetros adicionales requeridos.

(inclusive) funcionará.

{"page": 2, "limit": 90}

Otros

Parámetros de contexto

Estructura y procesamiento de datos

Diccionario de datos

Trabajar con múltiples AI Overviews

Ítem

Texto de la respuesta

Panel de fuente

Preguntas adicionales

Receta

Lista de información

Instrucción