Cómo raspar las descripciones de Google AI: Una guía completa para el SEO y el monitoreo de la visibilidad de la marca en IA.

Puntos Clave:

• Un actor, toda la superficie de AI Overview. scraper.overview devuelve el cuerpo de AI Overview (markdown + texto plano), el panel de fuentes citadas, las fuentes web relacionadas, las ubicaciones patrocinadas y el conjunto de banderas de compra, todo como JSON estructurado desde un solo POST HTTP.
• Salida residencial geográficamente vinculada. El campo input.country enrutará la solicitud a través de un proxy residencial coincidente geográficamente, de modo que la AI Overview generada por Google sea la que un usuario real en ese país vería. Verificado de extremo a extremo contra US y GB.
• Un sobre canónico. Cada respuesta exitosa es { status, task_id, task_result }. task_result.content es markdown con referencias de citación [N]; task_result.rawtext es el mismo cuerpo sin citaciones; task_result.source y task_result.web_source son los dos paneles de enlaces clasificados.
• Combinar con scraper.google.search y scraper.aimode. AI Overview es una superficie de AI de Google — la pestaña AI Mode y el SERP orgánico clásico son hermanos. Mismo cuenta de Scrapeless, mismo encabezado de autenticación.
• Gratis para comenzar. Nuevas cuentas de Scrapeless incluyen créditos gratuitos de la API de Scraper — regístrate en Sitio Web de Scrapeless.

Introducción: acceso estructurado a AI Overview de Google

AI Overview de Google (AIO) se sitúa en la parte superior del SERP para una creciente parte de consultas informativas, comparativas y de compras. Para los equipos de SEO ha reemplazado el Fragmento Destacado como la superficie de respuesta fundamental; para la monitorización de marcas, ahora es lo primero que un prospecto lee sobre un producto; para los pipelines de fundamentación de AI, es un conjunto curado de citas que Google ya ha validado por relevancia.

Raspar el AIO directamente del SERP renderizado es un objetivo en movimiento. El bloque se carga de manera diferida detrás de un marcador de "generación", la estructura cambia a través de variantes A/B, y el panel de citas se hidrata independientemente del cuerpo. Se puede hacer que un pipeline de raspado de DOM funcione, pero lleva el costo de mantenimiento de selectores de cualquier objetivo del lado del cliente — y aún necesita salida residencial, renderización de JavaScript y manejo de CAPTCHA en el fondo.

La API de AI Overview de Scrapeless Scraper (actor: "scraper.overview") reduce todo eso a un solo POST HTTP. El solicitante envía un aviso y un país; la API devuelve un sobre JSON estructurado con el cuerpo del AIO en dos formatos (markdown con citaciones, texto plano sin), las fuentes citadas, las fuentes web de búsqueda relacionadas, las ubicaciones patrocinadas por encima del AIO, y las banderas de compra/enlace de compra. La autenticación, el enrutamiento por proxy, la renderización de JavaScript, la encuesta de carga diferida y el mantenimiento de selectores son preocupaciones del lado del servidor.

Esta guía recorre la integración completa: por qué los equipos usan la API, la forma de la solicitud y la respuesta, referencia de parámetros y campos, clientes ejecutables en Python y Node.js, la matriz de errores observada en la verificación, y un breve recorrido por los actores complementarios (scraper.google.search, scraper.aimode) que completan un pipeline de Google-AI en producción.

Lo Que Puedes Hacer Con Esto

• Monitoreo de rango y presencia de AI Overview. Haz seguimiento de cuáles de tus palabras clave objetivo realmente muestran un AIO, y con qué frecuencia — la tasa de activación del AIO es en sí misma un KPI de SEO de alta señal en 2026.
• Seguimiento de citaciones GEO. Extrae la lista de dominios citados para cada AIO y agrega la cuota de citación por marca, por grupo temático, por geografía. Este es el equivalente GEO de la cuota de voz orgánica.
• Monitorización de marca en respuestas de AI. Observa qué reseñas de terceros, comparaciones y artículos editoriales superpuestos por el AIO de Google cuando los prospectos buscan tu marca o tus competidores.
• Auditorías de visibilidad de competidores. Compara las listas de fuentes citadas para las consultas de marca de un competidor contra las tuyas — la brecha es tu hoja de ruta de contenido GEO.
• Datos de entrenamiento para evaluación de LLM y RAG. Cada AIO es un tríplice curado de consulta → respuesta fundamentada → conjunto de citas. Capturado en un timestamp fijo y geografía proxy, es una verdad de referencia reproducible para evaluaciones de RAG y puntos de referencia de calidad de respuesta.
• Inteligencia de ubicaciones patrocinadas. La misma respuesta incluye los anuncios que se mostraron por encima del AIO para la misma consulta (anunciante, título, URL de visualización, token de seguimiento). Combínalo con el cuerpo del AIO para estudiar el comportamiento de los anunciantes en SERPs aumentados por AI.
• Superposición de intención de compra. task_result.is_overview_shopping, is_shopping y purchase_link son banderas a nivel de AIO que marcan consultas que Google ha clasificado como comerciales. Útil para pipelines de inteligencia de retail que filtran términos de intención de compra.
• Captura de múltiples localidades. Establece input.country por solicitud para leer el AIO que ven los usuarios reales en EE. UU., GB, DE, FR, JP y el resto de la huella de proxy residencial admitida.

En Scrapeless, solo accedemos a datos disponibles públicamente mientras cumplimos estrictamente con las leyes, regulaciones y políticas de privacidad de los sitios web aplicables. El contenido de este post es solo para fines de demostración.

Por qué la API Overview del Scraper AI sin Scrapear

La API convierte el bloque AI Overview de Google — una superficie de carga diferida, rotativa y sensible a la geolocalización — en una única llamada HTTP estructurada en JSON.

• Sin scraping de DOM, sin Playwright, sin mantenimiento de selectores. Envíe {prompt, country}, reciba {ads, content, rawtext, source, web_source, ...}. El cuerpo se entrega como markdown con referencias de cita en línea [N] y como un texto plano sin citas.
• Salida residencial fijada por país. El campo input.country enruta la solicitud a través de un proxy residencial geo-coincidente. La AI Overview devuelta es la que vería un usuario real en ese país — no un retroceso genérico de EE.UU.
• Carga diferida manejada del lado del servidor. Las AIO se renderizan detrás de un marcador de "generación" que el actor consulta del lado del servidor; esta consulta domina la latencia de ~12 a 18 segundos observada en la verificación. El llamador recibe solo el cuerpo establecido y no implementa un bucle de espera.
• Paneles de citas preanalizados. task_result.source es el panel de fuentes citadas de la AI Overview (los enlaces que Google atribuye a la respuesta); task_result.web_source es el panel de búsqueda relacionada que aparece debajo de la AIO. Ambos llegan como arreglos de {title, url, snippet, website_name, favicon, thumbnail}.
• Señales de compra como campos de primera clase. is_overview_shopping, is_shopping, y purchase_link marcan AIOs de intención comercial sin que el llamador tenga que analizar el cuerpo.
• Autenticación Scrapeless igual que el resto de la línea de productos. La API Overview del Scraper AI utiliza el mismo encabezado x-api-token que scraper.google.search, scraper.amazon, y la API de scraping universal. Una cuenta, muchas superficies.

Obtenga su clave API en el plan gratuito en Scrapeless Website. La línea del Scraper API se sitúa junto al Navegador de Scraping, API de Scraping Universal, y AI Agent en el catálogo de precios.

Requisitos previos

• Una cuenta de Scrapeless y clave API — regístrese en Scrapeless.
• Un terminal con curl (para la prueba de humo) o Python 3.10+ / Node.js 18+ para los clientes integrados a continuación.
• Familiaridad básica con HTTP y JSON.

Sin navegador, sin Playwright, sin plan de proxy que comprar por separado. El actor maneja la salida residencial, la renderización de JavaScript, la anti-detección y la consulta de carga diferida del lado del servidor.

Cómo funciona la API Overview del Scraper AI

La integración es un POST HTTP. Obtenga un token API del panel de Scrapeless y guárdelo como una variable de entorno:

export SCRAPELESS_API_TOKEN=your_token_here

El endpoint es POST https://api.scrapeless.com/api/v2/scraper/execute con el encabezado x-api-token: <YOUR_TOKEN> y un cuerpo JSON que nombra al actor y su entrada:

curl --location 'https://api.scrapeless.com/api/v2/scraper/execute' \
  --header 'Content-Type: application/json' \
  --header "x-api-token: ${SCRAPELESS_API_TOKEN}" \
  --data '{
    "actor": "scraper.overview",
    "input": {
        "prompt":  "mejores zapatillas para correr",
        "country": "US"
    }
}'

Una llamada exitosa devuelve HTTP 200 en ~15 segundos de principio a fin y el cuerpo es el sobre canónico a continuación.

Parámetros de solicitud

Sobre de respuesta

Una respuesta exitosa es un objeto JSON con tres claves de nivel superior:

{
  "status":    "success",
  "task_id":   "ca132d3f-dc04-464e-b652-53231a8aeb8f",
  "task_result": {
    "ads":                  [ /* ubicaciones patrocinadas sobre la AIO */ ],
    "content":              "**GraphQL** es un lenguaje de consulta de código abierto ... ([GraphQL][1]) ([Postman Blog][2]) ...\n\n[1]: https://graphql.org/ \"GraphQL — ...\"",
    "rawtext":              "GraphQL es un lenguaje de consulta de código abierto ...",
    "is_overview_shopping": true,
    "is_shopping":          true,
    "purchase_link":        true,
    "metadata":             { "rawUrl": "https://www.google.com/search?ApiType=overview&IsShopping=true&oq=...&q=..." },
    "products":             null,

"source":               [ /* Fuentes citadas en la descripción general de IA */ ],
    "web_source":           [ /* Fuentes web de búsqueda relacionada debajo de la AIO */ ]
  }
}

task_result campo referencia:

El sobre también lleva status ("success" o "failed") y task_id (un UUID para la ejecución) en el nivel superior. Almacene el task_id en sus propios registros: es la clave de correlación al presentar un ticket de soporte sobre una ejecución específica.

Integración de la API en Python

La integración completa es un único POST y un análisis .json(). El script a continuación lee el token de la API del entorno, llama al actor con prompt="mejores zapatillas para correr" y country="US", e imprime el cuerpo de AIO, las cinco mejores fuentes citadas y la cantidad de ubicaciones patrocinadas sobre la AIO.

import os
import requests

URL = "https://api.scrapeless.com/api/v2/scraper/execute"
HEADERS = {
    "x-api-token":  os.environ["SCRAPELESS_API_TOKEN"],
    "Content-Type": "application/json",
}
BODY = {
    "actor": "scraper.overview",
    "input": {
        "prompt":  "mejores zapatillas para correr",
        "country": "US",
    },
}

resp = requests.post(URL, headers=HEADERS, json=BODY, timeout=60)
resp.raise_for_status()
data = resp.json()

if data.get("status") != "success":
    raise SystemExit(f"La captura AIO falló: {data}")
# Si está "pending" o "running", use el "task_id" para reintentar y obtener los datos del resultado.

result = data["task_result"]

print(f"task_id = {data['task_id']}")
print(f"flags de compras: is_shopping={result['is_shopping']} "
      f"is_overview_shopping={result['is_overview_shopping']} "
      f"purchase_link={result['purchase_link']}\n")

# Cuerpo de texto plano — mejor para pipelines de LLM / embedding posteriores
print("=== Descripción general de IA (rawtext) ===")
print(result["rawtext"][:1200], "...\n")

# Top-5 fuentes citadas del panel de descripción general de IA
print("=== Principales fuentes citadas ===")
for s in result["source"][:5]:
    print(f"  - {s['website_name']:<20}  {s['url']}")

print(f"\nads encima de AIO: {len(result['ads'])}")

Una ejecución representativa de este script devuelve el cuerpo de AIO en 12–18 segundos e imprime de seis a doce fuentes citadas para la consulta.

Captura en bloque con reintento

En producción, envuelva la llamada en un pequeño bucle de reintentos. El actor ocasionalmente devuelve HTTP 400 con {"message":"execution failed","status":"failed","task_id":"..."} cuando Google no presenta una AIO para la consulta en una determinada geografía proxy o cuando el renderizado upstream es momentáneo. Reintentar con un pequeño retroceso generalmente lo resuelve:

import os, time, requests

URL = "https://api.scrapeless.com/api/v2/scraper/execute"
HEADERS = {
    "x-api-token":  os.environ["SCRAPELESS_API_TOKEN"],
    "Content-Type": "application/json",
}

def fetch_aio(prompt: str, country: str = "US", retries: int = 3, backoff: float = 3.0):
    body = {"actor": "scraper.overview", "input": {"prompt": prompt, "country": country}}
    last = None
    for attempt in range(retries):
        resp = requests.post(URL, headers=HEADERS, json=body, timeout=60)
        last = resp
        if resp.status_code == 200:
            payload = resp.json()
            if payload.get("status") == "success":
                return payload["task_result"]
        # transitorio: 400 con "ejecución fallida" es el caso retryable
        if resp.status_code == 400 and "ejecución fallida" in resp.text:
            time.sleep(backoff * (attempt + 1))
            continue
        # error crítico: mala autenticación, mal actor, falta de prompt — no reintentar
        resp.raise_for_status()
    raise RuntimeError(f"Scraping AIO agotó reintentos para {prompt!r}: {last.text}")

keywords = [
    "mejores zapatillas para correr",
    "mejores auriculares inalámbricos para correr",
    "cómo elegir zapatillas para correr",
]
for kw in keywords:
    result = fetch_aio(kw, country="US")
    print(f"\n=== {kw} ===")
    print(f"  fuentes citadas: {len(result['source'])}  "
          f"fuentes web: {len(result['web_source'])}  "
          f"anuncios: {len(result['ads'])}")

Este es el patrón estructural para el monitoreo por lote de palabras clave. Mantén la concurrencia moderada: de tres a cinco trabajadores paralelos por token es un buen punto de partida, y retrocede ante la señal de "ejecución fallida" en lugar de tratarla como un error crítico.

Obtén tu clave de API en el plan gratuito: Sitio Web de Scrapeless

Integración de la API en Node.js (18+)

La misma llamada en Node, utilizando el fetch incorporado:

const URL = "https://api.scrapeless.com/api/v2/scraper/execute";

async function fetchAIO(prompt, country = "US") {
  const resp = await fetch(URL, {
    method: "POST",
    headers: {
      "x-api-token":  process.env.SCRAPELESS_API_TOKEN,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      actor: "scraper.overview",
      input: { prompt, country },
    }),
  });

  if (!resp.ok) {
    const text = await resp.text();
    throw new Error(`HTTP ${resp.status}: ${text}`);
  }
  const payload = await resp.json();
  if (payload.status !== "success") {
    throw new Error(`Scraping AIO fallido: ${JSON.stringify(payload)}`);
  }
  return payload.task_result;
}

const result = await fetchAIO("mejores zapatillas para correr", "US");

console.log(`banderas de compras: is_shopping=${result.is_shopping} ` +
            `is_overview_shopping=${result.is_overview_shopping}`);

console.log("\n=== Resumen de AI (texto en bruto) ===");
console.log(result.rawtext.slice(0, 1200), "...\n");

console.log("=== Principales fuentes citadas ===");
for (const s of result.source.slice(0, 5)) {
  console.log(`  - ${s.website_name.padEnd(20)} ${s.url}`);
}

console.log(`\nanuncios encima de AIO: ${result.ads.length}`);

El patrón de reintento refleja la versión de Python: solo reintentar en HTTP 400 + "ejecución fallida"; tratar 401, 4xx con code: 14002 (actor no válido), y el error de validación en Prompt como errores críticos que no se solucionarán con ningún número de reintentos.

Actores complementarios para el scraping completo de Google-AI

La API de Resumen AI de Scraper cubre una superficie de Google AI. Las tuberías de producción que monitorean la visibilidad de la marca, construyen conjuntos de datos GEO o entrenan modelos de calidad de respuesta suelen necesitar dos más.

scraper.google.search — el SERP orgánico clásico

Para los diez enlaces azules debajo del AIO, las pares de la sección "Las Personas También Preguntan", el Panel de Conocimiento, el Fragmento Destacado y el bloque de Búsquedas Relacionadas, scraper.google.search es el contraparte estructurada. Los dominios de las fuentes citadas en el array source de scraper.overview son útiles en aislamiento, pero tienen mucho más sentido cuando se unen contra los 10 primeros orgánicos para la misma consulta: esa unión te dice si un dominio citado también está clasificando orgánicamente, y en qué posición.

scraper.aimode — la pestaña de Modo AI

El Modo AI de Google es una experiencia conversacional completa y separada que emerge del SERP. Reescribe la respuesta en un formato más parecido a un chat, toma prompts de seguimiento y utiliza un diseño de panel de citaciones diferente. scraper.aimode es el actor dedicado para ello. Para tener una imagen completa de cómo la Búsqueda AI de Google está presentando un tema, captura los tres: scraper.overview, scraper.google.search y scraper.aimode en la misma consulta, mismo país, mismo timestamp.

API de Scraping Universal para el resto del paisaje de respuestas LLM

Los Resúmenes AI de Google son una superficie de participación de citaciones. Para un programa GEO a nivel de marca, generalmente también necesitas monitorear los resultados de búsqueda de ChatGPT, las respuestas de Perplexity y otras experiencias de búsqueda impulsadas por LLM. La API de Scraping Universal es el camino dedicado para esos — mismo x-api-token, nombres de actores diferentes, misma forma de sobre JSON.

scraper.amazon (Rufus) para el lado comercial

Cuando la marca que se monitorea es un producto físico, Amazon Rufus es el otro extremo de la tubería de respuesta de IA. El actor de Amazon Rufus devuelve la respuesta fundamentada del asistente de compras conversacional para cualquier consulta de producto en lenguaje natural. Combinado con el AIO de Google, te indica cómo los dos mayores superficies de respuesta de IA posicionan tu producto o el de tus competidores.

Los cuatro actores comparten una cuenta de Scrapeless, un encabezado x-api-token y una forma de sobre. Configura un único envoltorio de cliente una vez y reutilízalo en toda la familia.

Cómo evitar problemas comunes

Respuestas de error que podrías ver

La API devuelve JSON estructurado para cada caso de error. El campo code, cuando está presente, es el código de error de Scrapeless; message es la explicación legible por humanos.

Los códigos 144xx son para autenticación y validación de actor; la carga útil de Field validation es la forma de solicitud; execution failed cubre tanto los casos de no-AIO como los transitorios en upstream. Siempre guarda el task_id de cualquier respuesta fallida; es lo que el soporte de Scrapeless necesita para correlacionar una única mala ejecución.

Parejas problema-solución

Problema: Una consulta devuelve execution failed una vez pero funciona al reintentar.
Solución: esta es la señal transitoria en upstream. La misma consulta que falla ahora suele tener éxito entre cinco y treinta segundos después. Reintenta con un margen de espera de 3 a 6 segundos y un pequeño presupuesto de intentos (3 intentos). Considera un fallo persistente en ese presupuesto como "no hay AIO disponible para esta consulta en esta geografía" en lugar de un error de integración.

Problema: Una consulta devuelve consistentemente execution failed sin importar el reintento.
Solución: no cada consulta de Google produce una visión general de IA. Consultas de una sola palabra, consultas de navegación ("facebook"), y consultas que Google no ha decidido fundamentar típicamente no lo hacen. Verifica abriendo https://www.google.com/search?q=<consulta> desde la misma geografía (VPN residencial o un dispositivo real); si no se genera un AIO para un usuario humano, el actor no producirá uno tampoco. Reformula la consulta para que sea más informativa ("¿cómo funciona X?", "mejor X para Y", "X vs Y").

Problema: task_result.products es null aunque is_shopping es true.
Solución: task_result.products se llena para algunos AIO de compras y es null para otros, incluso cuando is_shopping es verdadero. Cuando está presente, cada artículo lleva name, price, orig_price, discount, rating, review_count, seller, img, url, delivery, stores, y section_title (varios campos de texto pueden estar vacíos cuando Google no ha resaltado ese atributo). Cuando el campo es null, lee los candidatos de producto de task_result.source (el panel de fuentes citadas - a menudo páginas de minoristas) y analiza el cuerpo en formato markdown en task_result.content para las menciones de productos en línea. Siempre codifica defensivamente contra null: result.get("products") or [].

Problema: task_result.source y task_result.web_source parecen similares — ¿cuál es cuál?
Solución: source es el propio panel de citas de la Visión General de IA (los enlaces a los que se atribuye el AIO). web_source es el panel de búsqueda relacionada que se renderiza debajo del AIO. Para el seguimiento de citas GEO, cuenta desde source; para oportunidades de contenido relacionado, utiliza web_source.

Problema: El cuerpo del AIO en content tiene referencias de citas en markdown ([1], [2]) pero necesito prosa simple.
Solución: usa task_result.rawtext — es el gemelo sin citas, adecuado para incrustaciones, avisos de LLM posteriores, e ingestión de índices de búsqueda. Usa content cuando necesites mostrar la respuesta con atribución.

Problema: La misma consulta devuelve diferentes cuerpos de AIO en diferentes llamadas.
Solución: Las visiones generales de IA son no deterministas — Google las regenera por sesión y varían en horas y días. Para casos de monitoreo, fija la marca de tiempo y el country en cada captura y guarda la respuesta sin procesar; trata el cuerpo como una muestra, no como una constante. El conjunto de fuentes citadas tiende a ser más estable que el cuerpo en prosa.
Problema: Las restricciones de tasa y los límites de concurrencia no están en la documentación pública.
Solución: comienza con llamadas seriales. Aumenta la concurrencia gradualmente mientras observas si hay un HTTP 429 o un pico en ejecución fallida. Para canalizaciones de alto volumen sostenido, contacta al soporte de Scrapeless para obtener un carril dedicado.

Conclusión: AIO estructurados como una dependencia de una línea

La Descripción General de IA de Google se ha convertido en una superficie fundamental para SEO, GEO, monitoreo de marcas y canalizaciones de aterrizaje en IA. Rasparla a través de la automatización del DOM funciona, pero conlleva todo el mantenimiento de selectores, egreso residencial, carga diferida y manejo de CAPTCHA. La API de Descripción General de IA de Scrapeless reduce toda la integración a un único POST HTTP con tres campos requeridos (actor, input.prompt, input.country) y devuelve un sobre JSON estructurado donde el cuerpo del AIO, las fuentes citadas, el panel relacionado, los anuncios sobre el AIO y las banderas de compra son todos campos de primera clase.

Emparejado con scraper.google.search para el SERP orgánico y scraper.aimode para la pestaña Modo IA de Google, los tres actores juntos cubren toda la superficie de búsqueda aumentada por IA de Google desde una única cuenta de Scrapeless. La API de Raspeo Universal API extiende el mismo patrón a ChatGPT, Perplexity y otras superficies de respuestas de LLM — los bloques de construcción de un programa GEO de producción.

Regístrate en app.scrapeless.com para obtener créditos gratuitos de la API de Raspeo y lee la referencia completa de la API en apidocs.scrapeless.com.

¿Listo para construir tu canalización de búsqueda potenciada por IA?

Únete a nuestra comunidad para reclamar un plan gratuito y conectar con desarrolladores que están construyendo canalizaciones de GEO, IA de marcas y monitoreo de búsqueda sobre Scrapeless:
Discord
Telegram

Regístrate en Sitio Web de Scrapeless para obtener créditos gratuitos de la API de Raspeo y adapta los patrones anteriores a las palabras clave, países y términos de marcas que tu canalización necesita.

Preguntas Frecuentes

P1: ¿Es legal raspar las Descripciones Generales de IA de Google?
El contenido público de la Descripción General de IA que aparece en google.com es parte del resultado de búsqueda visible públicamente y se considera generalmente justo de acceder para investigación, monitoreo de SEO y análisis competitivo. Las jurisdicciones y casos de uso específicos difieren; el uso comercial, la redistribución del cuerpo del AIO y el acceso automatizado a gran escala pueden conllevar consideraciones adicionales bajo los Términos de Servicio de Google y la ley local de protección de datos. Revisa los Términos de Servicio de Google y tus regulaciones locales, y consulta a un abogado antes de publicar o redistribuir contenido de AIO raspado.

P2: ¿Cada consulta de Google produce una Descripción General de IA?
No. Google elige cuándo arrojar un AIO y la tasa varía según la clase de consulta, geografía, idioma y experimentos de productos en curso. Las consultas informativas, de comparación, "¿cómo funciona X?", "mejor X" y de intención de compra son las más propensas a desencadenar una en 2026. Las consultas de navegación ("facebook", "inicio de sesión de amazon") y las consultas ambiguas de una sola palabra generalmente no lo hacen. El actor devuelve ejecución fallida para consultas que Google no ancla en esa geografía.

P3: ¿Qué países son compatibles con input.country?
El campo de país acepta códigos ISO 3166-1 alpha-2 y se verifica de extremo a extremo contra US y GB. La huella de proxy residencial que respalda al actor abarca más de 195 países, por lo que la mayoría de los códigos comunes (DE, FR, JP, CA, AU, BR, IN, ES, IT, NL) funcionan; un código no compatible devuelve ejecución fallida. Verifica contra tu país específico con una pequeña prueba de humo antes de escalar.

P4: ¿Qué tan rápido es una llamada única?
La latencia de extremo a extremo es típicamente de 12 a 18 segundos en verificación. La mayor parte de eso es sondeo del lado del servidor para que la Descripción General de IA se asiente detrás del marcador de posición "generando" de Google; el actor devuelve solo el cuerpo renderizado, no el marcador de posición.

P5: ¿Puedo agrupar muchas consultas de manera concurrente?
Sí. Comienza con tres a cinco trabajadores paralelos por token y aumenta mientras observas la tasa de ejecución fallida. Las restricciones de tasa pública y los límites de concurrencia no están documentadas; contacta al soporte de Scrapeless para carriles de alto volumen.

P6: ¿Cómo se diferencia scraper.overview de scraper.google.search y scraper.aimode?
scraper.overview devuelve el bloque de Descripción General de IA específicamente — cuerpo, citas, panel relacionado, ubicaciones patrocinadas, banderas de compra. scraper.google.search devuelve el resto del SERP — diez enlaces orgánicos, Fragmento Destacado, Preguntas Relacionadas, Panel de Conocimiento, Búsquedas Relacionadas. scraper.aimode devuelve la página conversacional de Modo IA separada de Google. Para una vista completa de cómo Google Search presenta un tema, captura los tres en la misma consulta, mismo país, mismo timestamp.

P7: ¿Puedo obtener la lista estructurada de productos para AIOs de compras?
Sí, para algunos AIOs de compras. Cuando está poblado, task_result.products es un arreglo de {nombre, precio, precio_original, descuento, calificación, conteo_de_reseñas, vendedor, imagen, url, entrega, tiendas, título_sección} (varios campos de cadena pueden estar vacíos cuando Google no mostró ese atributo). Es null para otros AIOs de compras incluso cuando is_shopping es true — en la verificación, 1 de 5 capturas de compras devolvió un arreglo de 10 elementos; el resto fue nulo. Cuando el campo es nulo, lee los candidatos a productos de task_result.source (a menudo páginas de minoristas) y analiza las menciones en línea en task_result.content. Siempre codifica defensivamente contra null (result.get("products") o []).

Q8: ¿Qué significa is_overview_shopping y cómo se diferencia de is_shopping?
is_shopping es verdadero cuando el SERP subyacente tenía un módulo de compras (el carrusel encima de los resultados orgánicos). is_overview_shopping es verdadero cuando Google clasifica la Vista General de AI como orientada a compras. purchase_link es verdadero cuando el cuerpo del AIO contiene al menos una URL de compra directa. Usa la combinación para filtrar AIOs con intención comercial en las canalizaciones de inteligencia minorista.

Q9: ¿Necesito manejar yo mismo el marcador de carga perezosa?
No. Los AIOs se renderizan detrás de un marcador de "generar", y el actor sondea del lado del servidor hasta que el cuerpo se estabiliza antes de devolver. Ese sondeo es el componente dominante de la latencia de extremo a extremo de ~12–18 s. Los llamadores no implementan un bucle de espera.

Q10: ¿Cómo debo almacenar la respuesta para un monitoreo a largo plazo?
Referencia completa de la API y área de juego de solicitudes en vivo: apidocs.scrapeless.com. Documentos de SDK e integración: docs.scrapeless.com.