Los resultados de Gemini suman productos y lugares

Los resultados de GEMINI incluyen ahora las tarjetas de producto y los lugares que Gemini muestra en su respuesta.

Qué cambia

• shoppingCards: las tarjetas de producto que muestra Gemini, con título, posición, precio, tienda, valoración, reseñas, miniatura y productLink a la página del producto en Google.
• inlineProducts: los productos enlazados dentro del texto de la respuesta, con título, posición y productLink.
• map: los lugares que recomienda Gemini en preguntas sobre lugares, con dirección, coordenadas, teléfono, sitio web, enlace de Google Maps, valoración y categoría.

Cómo funciona

Cuando preguntas a Gemini qué comprar o adónde ir, buena parte de la respuesta está fuera del texto: una fila de tarjetas de producto con precios o una lista de lugares en un mapa. Ahora llegan como campos estructurados junto a text, en el orden en que Gemini los muestra, así que position te dice qué producto o lugar aparece primero.

price llega como {value, currency, raw}, así que comparar precios entre tiendas es directo. Cada lugar trae placeId, una location con address, latitude y longitude, y reviews con la valoración, el número de reseñas y su proveedor. Los títulos de las tarjetas siguen también en text, así que los recuentos de menciones basados en el texto mantienen las mismas cifras.

Para qué sirve

• Sigue si tu producto aparece en una tarjeta de producto de Gemini, en qué posición y a qué precio.
• Mira a qué tiendas envía Gemini a los compradores de tu categoría.
• Comprueba qué clínicas, restaurantes o tiendas recomienda Gemini en un barrio, con sus valoraciones.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": {
      "prompt": "Best ramen near me",
      "country": "US",
      "location": { "latitude": 40.72927, "longitude": -73.98736 }
    }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.promptstringObligatorio

La pregunta, escrita como la teclea un usuario en el chat. Hasta 100.000 caracteres.

payload.countrystring

Código de país de dos letras del mercado desde el que se pregunta, como US, KR o JP. Por defecto US.

payload.locationobject

Un punto dentro de country, con latitude (-90 a 90) y longitude (-180 a 180) en grados decimales, por ejemplo {"latitude": 37.4979, "longitude": 127.0276}. El motor responde como a un usuario que está allí. Para CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP.

payload.include.markdownboolean

Con true se añade markdown: la respuesta con sus títulos, listas, tablas y enlaces.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "success": true,
  "task": {
    "id": "685aad4a-3191-4215-9d2a-93ada8376185",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:51:49.105Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "**[IPPUDO NY](https://maps.google.com/?cid=13390953617500975094)** · ★ 4.4 (5,519) · Restaurant · 65 4th Ave, New York, NY 10003\n…",
    "map": [
      {
        "position": 4,
        "name": "IPPUDO NY",
        "category": "Restaurant",
        "location": {
          "address": "65 4th Ave, New York, NY 10003",
          "latitude": 40.730948,
          "longitude": -73.990287
        },
        "reviews": [
          { "count": 5519, "rating": 4.4, "providerName": "Google" }
        ],
        "phoneNumber": "+1 212-388-0088",
        "url": "https://www.ippudous.com/east-village",
        "mapsUrl": "https://maps.google.com/?cid=13390953617500975094"
      }
    ],
    "location": { "latitude": 40.72927, "longitude": -73.98736 }
  }
}

response.maparray

Lugares que recomienda la respuesta: nombre, dirección, coordenadas, valoración, categoría y enlace al mapa.

response.shoppingCardsarray

Fichas de producto que acompañan la respuesta: nombre, precio, tienda, valoración y enlace.

response.inlineProductsarray

Nombres de producto enlazados dentro de las frases de la respuesta, con position y productLink.

response.locationobject

El punto que usó la respuesta, tal como lo enviaste: latitude y longitude.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Precio

El precio sigue en 1 crédito por tarea completada, con productos y lugares incluidos.