Novedades22 oct 2026Nuevo

Google Shopping ya está disponible en Commerce Search y Commerce Product

API

Google Shopping con las etiquetas COMMERCE_SERP y COMMERCE_PRODUCT, los tres primeros productos de cerave moisturizing cream con precio, valoración y tienda, y las cuatro tiendas que Google muestra para el primero, desde Target a 4,19 $ hasta CVS Pharmacy a 7,49 $

Busca en la pestaña de Shopping de Google en EE. UU. con Commerce Search y lee cualquier producto con Commerce Product para obtener cada tienda que Google muestra, con su precio, stock y página de producto.

Qué obtienes

site: "google_shopping" en COMMERCE_SERP: una tarea busca en la pestaña de Shopping de Google en EE. UU. y devuelve hasta 40 productos en el orden de Google, cada uno con rank, productId, title, price y url.
seller: la tienda que aparece en cada tarjeta, como Target, Ulta Beauty o Walmart, junto a rating, reviewCount e imageUrl cuando la tarjeta los muestra.
COMMERCE_PRODUCT lee cualquier producto de esos resultados por su url y devuelve title, price, seller, inStock, rating, images y specs.
offers: todas las tiendas que Google muestra para el producto, cada una con seller, title, price, currency, inStock y la url de su propia página de producto.

Cómo funciona

Cada búsqueda lee la pestaña de Shopping que Google muestra para tu consulta en EE. UU., la página de google.com/search?udm=28. La url de un producto abre esa página de resultados y lleva el ID y el título del producto tras #; así COMMERCE_PRODUCT vuelve a encontrar el mismo producto.

La lectura abre la página de resultados, hace clic en el producto y lee el panel que Google muestra: tiendas, descripción, especificaciones y fotos. El price, listPrice, seller e inStock del producto vienen de la primera tienda, la que Google marca como mejor precio. Google reordena los resultados de las búsquedas amplias a lo largo del día, así que la lectura busca el producto primero por su consulta y después por su título.

reviewCount lleva el número exacto que muestra Google, hasta 1.000; por encima, Google lo abrevia como 17K.

Para qué sirve

Ve qué tienda tiene el mejor precio de Google para tu producto y cuánto más cobran las demás.
Sigue cada día los productos que Google Shopping posiciona en una búsqueda de categoría, junto a los rankings de Amazon, Walmart y Target para la misma consulta.
Reúne las páginas de producto de todas las tiendas que venden un producto y lee la de Target, Walmart o Ulta con Commerce Product.

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": "COMMERCE_SERP",
    "payload": {
      "site": "google_shopping",
      "query": "cerave moisturizing cream",
      "limit": 10
    }
  }'

Campos de la solicitud

taskTypestringObligatorio: El motor que se ejecuta, como CHATGPT o GOOGLE.
payload.sitestringObligatorio: La tienda en la que se busca, como amazon, coupang o rakuten. Los 21 valores figuran con el motor.
payload.querystringObligatorio: La búsqueda, escrita como la teclea un comprador en el buscador de la tienda. De 1 a 500 caracteres.
payload.countrystring: El país de la tienda, como US para amazon o KR para coupang. También es el valor predeterminado.
payload.limitinteger: Productos que se devuelven, de 1 a 40. Por defecto, 20.
webhook.urlstring: Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

Respuesta

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

JSON

{
  "success": true,
  "task": {
    "id": "b02ec42c-2ea1-4a6f-ba70-1b3099b8ceff",
    "taskType": "COMMERCE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-23T01:32:45.682Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "google_shopping",
    "query": "cerave moisturizing cream",
    "country": "US",
    "returnedCount": 10,
    "products": [
      {
        "rank": 1,
        "productId": "16245040360969784676",
        "title": "CeraVe Moisturizing Cream",
        "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream",
        "price": 4.19,
        "currency": "USD",
        "seller": "Target",
        "rating": 4.7
      },
      {
        "rank": 2,
        "productId": "5074307725217910967",
        "title": "CeraVe Moisturizing Cream Pump",
        "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=5074307725217910967&title=CeraVe+Moisturizing+Cream+Pump",
        "price": 17.99,
        "currency": "USD",
        "seller": "Target",
        "rating": 4.7
      },
      "…"
    ]
  }
}

task.statusstring: QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.
credits.creditsChargedinteger: Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.
response.returnedCountinteger: El número de productos en products.
response.productsarray: Los productos en el orden de Google: rank, productId, title, url, price, currency y seller, además de rating, reviewCount e imageUrl cuando la tarjeta los muestra.

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"

Leer un producto

Pasa la url de un producto de los resultados a COMMERCE_PRODUCT. Esta es la lectura del primer producto de arriba, recortada.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "COMMERCE_PRODUCT",
    "payload": {
      "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream"
    }
  }'

taskTypestringObligatorio: El motor que se ejecuta, como CHATGPT o GOOGLE.
payload.urlstringObligatorio: La url de un producto de un resultado de Commerce Search con google_shopping. Abre la página de resultados y lleva el ID y el título del producto tras #.

JSON

{
  "success": true,
  "task": {
    "id": "9ee619d2-c87f-47ab-93cd-215ef3671734",
    "taskType": "COMMERCE_PRODUCT",
    "status": "COMPLETED",
    "createdAt": "2026-10-23T01:36:00.797Z"
  },
  "credits": { "creditsToCharge": 3, "creditsCharged": 3 },
  "response": {
    "site": "google_shopping",
    "country": "US",
    "url": "https://www.google.com/search?q=cerave+moisturizing+cream&udm=28&gl=us&hl=en#product=16245040360969784676&title=CeraVe+Moisturizing+Cream",
    "productId": "16245040360969784676",
    "title": "CeraVe Moisturizing Cream",
    "price": 4.19,
    "currency": "USD",
    "inStock": true,
    "seller": "Target",
    "rating": 4.7,
    "images": [
      "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcTdoC3RoTxQCkmpSUypL2HqkAR300eBZ_E3W2NCfz2MP4541LroFfQ8ZzNM2XIpm_xS_3c4dZU4_LMYtqQjE89N-Z8wH4Y_gA",
      "…"
    ],
    "specs": [
      { "name": "Benefit", "value": "Moisturizing" },
      { "name": "Form", "value": "Cream" },
      "…"
    ],
    "offers": [
      {
        "seller": "Target",
        "title": "CeraVe Moisturizing Face & Body Cream for Normal to Dry Skin – 1.89 fl oz",
        "url": "https://www.target.com/p/cerave-moisturizing-face-38-body-cream-for-normal-to-dry-skin-8211-1-89-fl-oz/-/A-86467779",
        "price": 4.19,
        "currency": "USD",
        "inStock": true
      },
      {
        "seller": "Ulta Beauty",
        "title": "CeraVe Moisturizing Cream Body and Face Moisturizer - 1.8 oz",
        "url": "https://www.ulta.com/p/moisturizing-cream-body-face-moisturizer-xlsImpprod3530069?sku=2532670",
        "price": 6.99,
        "currency": "USD",
        "inStock": true
      },
      "…"
    ]
  }
}

response.pricenumber: Lo que paga el comprador por el producto tal como la página lo muestra primero, antes de cupones y envío, en currency (ISO 4217). listPrice es el precio habitual tachado cuando supera a price.
response.offersarray: Las tiendas que Google muestra para el producto, en su orden: seller, title, price, currency y la url de la página de producto de la tienda, además de listPrice e inStock cuando la fila los muestra. La primera tienda es el mejor precio de Google.

Errores

VALIDATION_ERRORHTTP 422: site queda fuera de las 21 tiendas, query está vacío o supera los 500 caracteres, limit queda fuera de 1 a 40 o el payload lleva otro campo. details indica el campo.
VALIDATION_ERRORHTTP 422: Falta url, supera los 2.048 caracteres o queda fuera de las páginas de producto de las 18 tiendas, o el payload lleva un campo distinto de url y country. details indica el campo.
REGION_UNSUPPORTEDHTTP 422: country es un país distinto del de la tienda, como KR con amazon.
MISSING_API_KEYHTTP 401: Falta la cabecera Authorization, o su clave es desconocida, caducó o fue revocada.
INSUFFICIENT_CREDITSHTTP 402: El saldo es menor que el precio de la tarea. Añade créditos o mejora el plan y vuelve a enviarla.

Precio

Cada búsqueda completada y cada lectura completada usa 3 créditos, como en las demás tiendas. Los créditos se cobran cuando la tarea se completa.

Más novedades

API22 oct 2026Nuevo
Mira cuánto de tu página lee ChatGPT
Envía la URL de una página a GEO Score y recibe qué parte de la página guarda ChatGPT search, qué recibe ChatGPT cuando abre la página y la causa y la solución de cada pieza que falta.
API22 oct 2026Nuevo
Presentamos Commerce Product
Pasa la URL de una página de producto de Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando y otras 11 tiendas, y recibe su precio, stock, imágenes de galería y de descripción, especificaciones y opciones en el mismo formato.

Recibe las actualizaciones por correo.

Feed RSS