Gemini Scraper
scraper.gemini extrae respuestas de Gemini para que pueda archivar salidas de inteligencia artificial de Google con metadatos estructurados de citas.
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.gemini",
"input": {
"prompt": "Recommended attractions in New York",
"country": "US"
},
"webhook": {
"url": "http://www.youwebhook.com"
}
}'Parámetros del cuerpo
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
prompt | string | Sí | Prompt enviado a Gemini. |
country | string | Sí | Código del país o región. |
shopping | boolean | No | Indica si se deben obtener datos de compras. Valor predeterminado: false. Cuando está habilitado, la respuesta incluye información adicional sobre productos en el campo products : ofertas de comerciantes detrás de cada grupo de productos, como URL directa de la tienda, precio, cuotas, disponibilidad, entrega y devoluciones. |
Campos de respuesta
Nota: Cuando
shoppingestá 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 | Respuesta en formato Markdown. |
rawtext | string | Datos originales de la respuesta. |
prompt | string | Indicación original. |
citations | array | Metadatos de la cita. |
citations.favicon | string | URL del favicon. |
citations.highlights | array | Fragmentos resaltados del texto fuente. |
citations.snippet | string | Fragmento de la cita. |
citations.title | string | Título de la página citada. |
citations.url | string | URL de la página citada. |
citations.website_name | string | Nombre del sitio web. |
related_queries | array | Matriz de consultas de fan-out. |
products | array | Información del producto devuelta por Google Gemini. |
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. |