AI Overviews

Extrae Google AI Overviews de los resultados de búsqueda con datos analizados para texto de respuesta, listas con viñetas, paneles de fuentes y listas de información.

La 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 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 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 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 funciones SERP de AI Overviews.

Disponibilidad regional de AI Overviews

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

Francia
Mónaco
China
Irán
Sudán
Siria
Cuba
Corea del Norte

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

Ejemplos de solicitud

A continuación se muestran ejemplos de código que usan google_search la fuente de Web Scraper API para capturar Google AI Overviews.

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

# Obtener respuesta.
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);

https://realtime.oxylabs.io/v1/queries?source=google_search&query=Emporio%20Armani%20EA3192&render=html&user_agent_type=desktop&access_token=12345abcde

{
    "source": "google_search",
    "query": "how to sell on amazon",
    "render": "html",
    "user_agent_type": "desktop"
}

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

Trabajando con múltiples AI Overviews

Dado que AI Overviews ahora se devuelve como un array, debes iterar sobre ellos:

// 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 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 'fragments' in answer:
                for text_item in answer['fragments']:
                    print(f"Answer text: {fragment['text']}")
    
    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']:
                    point_text = point['text'];
                    print(f"- {point_text}")
    # 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 el texto de respuesta
        if (isset($aiOverview['answer_text']) && is_array($aiOverview['answer_text'])) {
            foreach ($aiOverview['answer_text'] as $answer) {
                if (isset($answer['fragments']) && is_array($answer['fragments'])) {
                    foreach ($answer['fragments'] as $fragment) {
                        $textItem = $fragment['text'];
                        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) {
                        $pointText = $point['text'];
                        echo "- {$pointText}\n";
                    }
                }
            }
        }
        // Continuar procesando otros elementos...
    }
}
?>

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

Parámetros de la solicitud

Genérico

Opciones básicas de configuración y 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

consulta

La palabra clave o frase que se buscará.

render

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

contexto: expand_aio

Establécelo 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 para 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 de búsqueda avanzada de Google

Al extraer datos, puede resultarte útil combinar los operadores de búsqueda avanzada 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í. Mira 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 y lenguajes específicos.

Parámetro

Descripción

Valor predeterminado

geo_location

La 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 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

contexto:limit_per_page

Extrae varias páginas usando la misma dirección IP y sesión (cookie establecida). Al especificar los números de página en un array JSON con la page clave e indicar el número de resultados orgánicos por página usando la limit clave, 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

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

Límite por página

Debido a los recientes cambios 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 array 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 servirá

1

limit

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

90

Solicitar ejemplo

{
    "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 diversos criterios. Aprende a usar los parámetros de contexto aquí.

Parámetro

Descripción

Valor predeterminado

contexto: filter

Establecer el valor de este parámetro en 0 te permite ver resultados que de otro modo quedarían excluidos por su similitud con otros resultados.

1

contexto: safe_search

Búsqueda segura. Establécelo en true para activarlo.

false

contexto: udm

udm el parámetro permite cambiar entre distintas pestañas de búsqueda, como imágenes, lugares o videos, para personalizar el tipo de resultados mostrados. Encuentra los valores aceptados aquí.

contexto: tbm

A emparejar o tbm parámetro. Los valores aceptados son: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

contexto: tbs

Este parámetro es como un contenedor para parámetros menos conocidos de Google, como limitar/ordenar resultados por fecha, así como otros filtros, algunos de los cuales dependen del tbm parámetro (p. ej. tbs=app_os:1 solo está disponible con tbm valor app). Más información aquí.

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 simultáneamente puede provocar conflictos o un comportamiento inesperado.

Otros

Configuraciones y controles avanzados adicionales para requisitos especializados.

Parámetro

Descripción

Valor predeterminado

contexto: fpstate

Establecer el fpstate valor en aig hará que Google cargue más aplicaciones. Este parámetro solo es útil si se usa junto con el render parámetro.

contexto: nfpr

true desactivará la autocorrección ortográfica

false

Parámetros de contexto

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

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

Salida estructurada

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_overviews)

Descripción

Tipo

answer_text

Información general sobre el término de la consulta de Google Search.

arreglo

bullet_list

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

arreglo

source_panel

Una lista de fuentes usadas para generar el resultado de AI Overviews en la función SERP de Google.

objeto

info_list

Una lista de información usada con mayor frecuencia para representar los pasos de un proceso relevante para la consulta de búsqueda.

arreglo

pos_overall

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

entero

General

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

{
  "ai_overviews": [
    {
      "answer_text": [
        {
          "fragments": [
            {
              "text": "Emporio Armani is a luxury brand known for timeless designs.",
              "references": [
                {
                  "source": "http://italist.com ",
                  "url": "https://www.italist.com/magazine/what-is-emporio-armani/ "
                }
              ]
            }
          ],
          "pos": 1
        }
      ],
      "bullet_list": [
        {
          "list_title": "Pros",
          "points": [
            {"text": "Comfortable"},
            {"text": "Minimal branding"}
          ],
          "pos": 1
        }
      ],
      "source_panel": {
        "items": [
          {
            "url": "https://www.italist.com/...",
            "source": "http://italist.com ",
            "title": "What is Emporio Armani...",
            "pos": 1
          }
        ]
      },
      "pos_overall": 1
    }
  ]
}

Texto de respuesta

...
"answer_text": [
  {
    "fragments": [
      {
        "text": "Emporio Armani is a luxury brand known for timeless designs.",
        "references": [
          {
            "source": "http://italist.com",
            "url": "https://www.italist.com/magazine/what-is-emporio-armani/"
          }
        ]
      }
    ],
    "pos": 1
  }
]
...

Clave (results.ai_overviews.answer_text)

Descripción

Tipo

fragments

Una respuesta breve a la consulta de Google Search.

arreglo

fragments.text

El contenido del texto de respuesta del fragmento.

cadena

fragments.references

Una lista de fuentes citadas por el fragmento.

arreglo

fragments.references.source

El nombre de la fuente citada.

cadena

fragments.references.url

La URL de la fuente citada.

cadena

pos

Un indicador que denota la posición de un elemento dado entre todos los resultados de respuesta de AI Overviews.

entero

Lista con viñetas

...
"bullet_list": [
  {
    "list_title": "Pros",
    "points": [
      {"text": "Comfortable"},
      {"text": "Minimal branding"}
    ],
    "pos": 1
  }
]
...

Clave (results.ai_overviews.bullet_list)

Descripción

Tipo

list_title

El título de la lista con viñetas.

cadena

points

Los elementos renderizados en la lista con viñetas. Todos los elementos están separados por comas.

arreglo

points.text

El contenido textual del punto con viñeta.

cadena

points.references

Una lista de fuentes citadas por el punto con viñeta (opcional).

arreglo

pos

Un indicador que denota la posición de un elemento dado entre todos los resultados de lista con viñetas de AI Overviews.

entero

Panel de fuentes

...
"source_panel": {
  "items": [
    {
      "url": "https://www.italist.com/...",
      "source": "http://italist.com",
      "title": "What is Emporio Armani...",
      "pos": 1
    }
  ]
}
...

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.

objeto

items.url

La URL del sitio web.

cadena

items.source

El nombre del sitio web.

cadena

items.title

El título del artículo.

cadena

items.pos

Un indicador que denota la posición de un elemento dado entre todos los resultados del panel de fuentes de AI Overviews.

entero

Lista de información

Clave (results.ai_overviews.info_list)

Descripción

Tipo

list_title

El título de la lista.

cadena

list_items

Contiene una lista de elementos con sus respectivos detalles.

arreglo

list_items.title

El título de la sección dentro de la lista.

cadena

list_items.content

Una breve descripción de la sección.

arreglo

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.

entero

Instrucciones

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

...
  "ai_overviews": [
    {
      "answer_text": [
        {
          "fragments": [
            "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
        },
        {
          "fragments": [
            "The syntax for the docker exec command is as follows:"
          ],
          "pos": 2
        },
        ...
        }
      ]
    }
  ],
...

Texto de respuesta

"answer_text": [
  {
    "fragments": [
      "The docker exec...",
      "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
  }
]

Clave (results.ai_overviews.answer_text)

Descripción

Tipo

fragments

Fragmento de respuesta de la consulta de Google Search en texto plano.

array de cadenas

pos

Un indicador que denota la posición del elemento en la respuesta del Overview.

entero

AnteriorModo de IA

SiguienteLens

Última actualización hace 18 días

¿Te fue útil?