Google AI Mode Scraper

scraper.aimode refleja las respuestas del modo Google AI, incluido el HTML renderizado, las URL en bruto y los datos detallados de citas, para que usted pueda auditar cómo varían los resultados según las ubicaciones.

Ejemplo de solicitud

curl 'https://api.scrapeless.com/api/v2/scraper/request' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: {you_api_key}' \
  --data '{
    "actor": "scraper.aimode",
    "input": {
      "prompt": "Recommended attractions in New York",
      "country": "US",
      "shopping": true
    },
    "webhook": {
      "url": "http://www.youwebhook.com"
    }
  }'

Parámetros del cuerpo

Parámetro	Tipo	Requerido	Descripción
`prompt`	string	Sí	Prompt enviado a Google AI Mode.
`country`	string	Sí	Código del país o región.
`shopping`	boolean	No	Indica si se deben obtener datos de compras. El valor predeterminado es `true`. Cuando está habilitado, la respuesta incluye información adicional sobre productos en el campo `products` —las ofertas de comerciantes detrás de cada grupo de productos, como URL directa de la tienda, precio, cuotas, stock, entrega y devoluciones.
`location`	string	No	Nombre canónico de ubicación de Google para resultados geodirigidos (por ejemplo, Nueva York, Nueva York, Estados Unidos). Consulte la lista de ubicaciones geográficas admitidas por Google para ver todas las ubicaciones compatibles. Exclusivo con uule.
`uule`	string	No	Cadena UULE pre-codificada de Google para geolocalización precisa. Utilice este parámetro cuando tenga un valor UULE ya construido en lugar de un nombre de ubicación. Exclusivo con location.
`url`	string	No	Enlace completo de acceso a Google AI Mode. Exclusivo respecto a todos los demás parámetros. Si se proporciona este parámetro, no es necesario enviar ningún otro y serán ignorados automáticamente si se envían.
`should_fetch_share_link`	boolean	No	Obtener enlace para compartir.

Campos de respuesta

Nota: Cuando shopping está habilitado y la respuesta incluye esta información adicional del producto, la llamada a la API se cobra a 2 veces la tarifa base. Esto se debe a los recursos adicionales necesarios para extraer y procesar información de productos de varias fuentes.

Parámetro	Tipo	Descripción
`result_text`	string	Cuerpo de la respuesta.
`result_md`	string	Cuerpo de la respuesta en formato Markdown.
`result_html`	string	Versión HTML de la respuesta.
`raw_url`	string	URL original de Google AI Mode.
`citations`	array	Fuentes de citas.
`citations.snippet`	string	Fragmento del artículo citado.
`citations.thumbnail`	string	Imagen de portada del artículo citado.
`citations.title`	string	Título de la cita.
`citations.url`	string	URL de la cita.
`citations.website_name`	string	Nombre del sitio web.
`citations.favicon`	string	Favicon del sitio web.
`search_result`	array	Resultados de búsqueda opcionales referenciados por Google.
`search_result.snippet`	string	Fragmento del resultado de búsqueda.
`search_result.thumbnail`	string	Imagen de portada del resultado de búsqueda.
`search_result.title`	string	Título del resultado de búsqueda.
`search_result.url`	string	Enlace del resultado de búsqueda.
`search_result.website_name`	string	Nombre del sitio web del resultado de búsqueda.
`products`	array	Información del producto devuelta por el modo Google AI.
`products.thumbnails`	array	Matriz de URLs de imágenes en miniatura del producto.
`products.title`	string	Título del producto.
`products.url`	string	URL de la página del producto.
`products.brand`	string	Nombre de la marca del producto.
`products.reviews`	int	Número de reseñas.
`products.rating`	string	Puntuación media de valoración.
`products.price_range`	string	Rango de precios, por ejemplo, `$2,499.99`.
`products.stores`	array	Matriz de ofertas de tiendas.
`products.stores.name`	string	Nombre de la tienda.
`products.stores.link`	string	Enlace al producto en la tienda.
`products.stores.title`	string	Título del producto en la tienda.
`products.stores.ratings`	string	Calificación de la tienda, por ejemplo, `4.3/5`.
`products.stores.extensions`	array	Información adicional (disponibilidad, entrega, devoluciones).
`products.stores.price`	string	Precio en la tienda.
`products.stores.delivery_fee`	string	Información sobre la tarifa de envío.
`products.stores.total_price`	string	Precio total incluyendo tarifas.
`products.about_the_product`	object	Información detallada del producto.
`products.about_the_product.title`	string	Título de la sección.
`products.about_the_product.link`	string	Enlace a la página del producto.
`products.about_the_product.displayed_link`	string	Nombre de dominio mostrado.
`products.about_the_product.features`	array	Características/especificaciones del producto.
`products.about_the_product.features.title`	string	Nombre de la característica.
`products.about_the_product.features.value`	string	Valor de la característica.
`products.about_the_product.description`	string	Descripción del producto.
`products.variants`	array	Opciones de variante del producto.
`products.variants.title`	string	Título de la categoría de variante.
`products.variants.items`	array	Lista de opciones de variante.
`products.variants.items.name`	string	Nombre de la opción de variante.
`products.variants.items.selected`	bool	Indica si esta variante está seleccionada.
`products.variants.items.availability`	bool	Estado de disponibilidad de la variante.
`products.ratings`	array	Datos de distribución de calificaciones.
`products.ratings.stars`	int	Nivel de calificación en estrellas (1-5).
`products.ratings.amount`	int	Número de calificaciones en este nivel.
`products.user_reviews`	array	Datos de reseñas de usuarios.
`products.user_reviews.text`	string	Contenido del texto de la reseña.
`products.user_reviews.source`	string	Plataforma de origen de la reseña.
`products.user_reviews.rating`	int	Puntuación de la reseña del usuario.
`products.user_reviews.date`	string	Fecha de la reseña.
`products.user_reviews.name`	string	Nombre del revisor.
`products.user_reviews.title`	string	Título de la reseña.
`share_url`	string	Enlace para compartir.

Gemini Google AI Overview