> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Shopping API

> Busca productos en la tienda Google Shopping y lee sus páginas de producto como JSON: posiciones con precios, valoraciones, número de reseñas y vendedores en la búsqueda, y precio, disponibilidad, vendedor, imágenes y especificaciones en cada página de producto.

Busca productos en la tienda Google Shopping (shopping.google.com) y lee sus páginas de producto mediante la API de tareas asíncronas. Envía `COMMERCE_SERP` con `site` `google_shopping` para recibir los productos que muestra una búsqueda, en el orden de la tienda, o `COMMERCE_PRODUCT` con la `url` de un producto para leer ese producto. Cada búsqueda o página de producto completada cuesta **2 créditos**.

## Búsqueda

```bash theme={"theme":"css-variables"}
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": "wireless earbuds", "limit": 3 } }'
```

Envía la tarea y luego consulta `GET /v1/async/task/{id}` o recibe su webhook. Consulta [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md).

### Parámetros

* `site`: Obligatorio. `google_shopping`.
* `query`: Obligatorio. Consulta de búsqueda, de 1 a 500 caracteres.
* `limit`: Entero opcional de 1 a 40, con 20 por defecto.
* `country`: Opcional. Por defecto, `US`, el país de la tienda. Cualquier otro país se rechaza con `422 REGION_UNSUPPORTED`.

Solo se aceptan los campos de payload enumerados arriba. Omite `include`: incluso `include: {}` devuelve `422 VALIDATION_ERROR` en `payload.include` antes de reservar créditos.

### Ejemplo de respuesta

```json theme={"theme":"css-variables"}
{
  "site": "google_shopping",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 3,
  "products": [
    {
      "rank": 1,
      "productId": "1067219252613399794",
      "title": "JLab Go Air Sport True Wireless Earbuds",
      "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=1067219252613399794&title=JLab+Go+Air+Sport+True+Wireless+Earbuds",
      "price": 9.88,
      "currency": "USD",
      "rating": 4.1,
      "seller": "Walmart"
    },
    {
      "rank": 2,
      "productId": "5295866786049939613",
      "title": "JBL Vibe Beam 2 Noise Cancelling True Wireless Earbuds",
      "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=5295866786049939613&title=JBL+Vibe+Beam+2+Noise+Cancelling+True+Wireless+Earbuds",
      "price": 39.95,
      "currency": "USD",
      "rating": 4.2,
      "seller": "Best Buy",
      "imageUrl": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTxk4D_LlWLl4n-ponPRc2ihvXVxc8LIg5CGbLCdzmKDbN8zVii50zLQ0tUpH6TwjuCdY2RS3wRw93no9--JdlU6yG_udswoQ"
    },
    {
      "rank": 3,
      "productId": "549048356659243400",
      "title": "Beats Solo Buds True Wireless Earbuds",
      "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=549048356659243400&title=Beats+Solo+Buds+True+Wireless+Earbuds",
      "price": 69.99,
      "currency": "USD",
      "rating": 3.8,
      "seller": "Target",
      "imageUrl": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSQnGg6ee9gh0KOOWZFMqbmbUGjWa3kZ5V5EBOzJjb6JRM9z6TdPAoGlSi5_f6cPsEXle-oiBJ8EJ-FaREc98Wqt8jC8WzmfQ"
    }
  ]
}
```

### Campos del resultado

* `site`, `query` y `country` repiten la solicitud. `returnedCount` es el número de elementos de `products`.
* Cada producto incluye `rank`, `productId`, `title` y `url`. `productId` es el ID de producto de Google, o el ID de la oferta para un anuncio que Google no ha agrupado en un producto. `rank` sigue el orden predeterminado de la tienda, y se omiten los anuncios que la tienda marca como patrocinados.
* `price`, `rating`, `reviewCount`, `imageUrl` y `seller` aparecen cuando la página de resultados los muestra. `price` es un número en la `currency` del producto (ISO 4217); cuando los tamaños tienen precios distintos, es el más bajo.
* `rating` usa una escala de cinco puntos. Los números de reseñas abreviados, como 999+, se omiten. `reviewCount` solo aparece cuando Google muestra el número exacto (menos de 1.000).
* Cada búsqueda devuelve productos de la primera página de resultados de la tienda.
* La página de Google no enlaza ninguna página de producto ni de comerciante, así que `url` es la página de resultados de Google Shopping donde se clasificó el producto, con `#product={productId}&title={title}` al final. Pasa esa `url` a `COMMERCE_PRODUCT` para leer las tiendas, las especificaciones y la descripción del producto. `seller` es la tienda que Google muestra primero.

## Página de producto

```bash theme={"theme":"css-variables"}
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=wireless+earbuds&udm=28&gl=us&hl=en#product=5295866786049939613&title=JBL+Vibe+Beam+2+Noise+Cancelling+True+Wireless+Earbuds" } }'
```

### Parámetros

* `url`: Obligatorio. La `url` de un producto que devolvió una búsqueda de Google Shopping, de hasta 2.048 caracteres: `google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}`. El `productDetailUrl` de un producto de los resultados de [Google Search](https://docs.querying.ai/es/engines/google-serp.md), [Google AI Overviews](https://docs.querying.ai/es/engines/google-ai-overviews.md) y [Google AI Mode](https://docs.querying.ai/es/engines/google-ai-mode.md) también sirve tal cual.
* `country`: Opcional. Por defecto, el `gl` de la `url`, uno de `US`, `GB`, `AU`, `CA`, `KR`, `JP`, `TW`, `HK`, `DE`, `FR`, `ES`, `IT`, `PL`, `PT`, `BR`, `IN`, `ID`, `TH` y `VN`. Cualquier otro país se rechaza con `422 REGION_UNSUPPORTED`.

Solo se aceptan los campos de payload enumerados arriba. Omite `include`: incluso `include: {}` devuelve `422 VALIDATION_ERROR` en `payload.include` antes de reservar créditos.

### Ejemplo de respuesta

```json theme={"theme":"css-variables"}
{
  "site": "google_shopping",
  "country": "US",
  "url": "https://www.google.com/search?q=wireless+earbuds&udm=28&gl=us&hl=en#product=5295866786049939613&title=JBL+Vibe+Beam+2+Noise+Cancelling+True+Wireless+Earbuds",
  "productId": "5295866786049939613",
  "title": "JBL Vibe Beam 2 Noise Cancelling True Wireless Earbuds",
  "brand": "JBL",
  "price": 39.95,
  "listPrice": 65,
  "currency": "USD",
  "inStock": true,
  "seller": "Scheels",
  "rating": 4.2,
  "images": [
    "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcTxk4D_LlWLl4n-ponPRc2ihvXVxc8LIg5CGbLCdzmKDbN8zVii50zLQ0tUpH6TwjuCdY2RS3wRw93no9--JdlU6yG_udswoQ",
    "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQ64EZlooEjcI4GdHBULPySzyZvLSCxjsMi8raMFjbWdZv_KK0cL6P2pIc7nts3uk7G0_XBWBBhVjcuz92sCo2lcDw4hW2H"
  ],
  "description": "The JBL Vibe Beam 2 is a true wireless in-ear earbud system designed to deliver strong audio performance, effective noise control, and seamless everyday usability. Equipped with Bluetooth 5.3, it…",
  "specs": [
    { "name": "Brand", "value": "JBL" },
    { "name": "Noise Canceling", "value": "Yes" },
    { "name": "With Microphone", "value": "Yes" }
  ],
  "offers": [
    {
      "price": 39.95,
      "title": "JBL Vibe Beam 2 headphones",
      "seller": "Scheels",
      "inStock": true,
      "currency": "USD",
      "listPrice": 65
    },
    {
      "url": "https://www.walmart.com/ip/JBL-Vibe-Beam-2-True-Wireless-Noise-Cancelling-In-Ear-Earbuds-Black/21106652379?wmlspartner=wlpa&selectedSellerId=609&veh=seo_fpl&cn=google",
      "price": 39.77,
      "title": "Jbl Vibe Beam 2 True Wireless Noise Cancelling In-Ear Earbuds, Black",
      "seller": "Walmart - Electronics Expo (Authorized Dealer)",
      "inStock": true,
      "currency": "USD"
    }
  ]
}
```

### Campos del resultado

* `site`, `country`, `url` y `productId` identifican la página. `url` es la página que se leyó, y `productId` coincide con el que devuelve una búsqueda.
* `title` siempre está presente. `brand`, `price`, `listPrice`, `currency`, `inStock`, `seller`, `rating`, `reviewCount`, `images`, `description`, `specs` y `offers` aparecen cuando la página los muestra.
* `price` es lo que paga un comprador tal como la página lo muestra al abrirse, antes de cupones y envío, en `currency` (ISO 4217). `listPrice` es el precio habitual que la página tacha, presente cuando es mayor que `price`. `inStock` es la disponibilidad del producto. `seller` es el comerciante que lo vende.
* `rating` usa una escala de cinco puntos con dos decimales. `reviewCount` es el número de reseñas. `reviewCount` solo aparece cuando Google muestra el número exacto (menos de 1.000).
* `images` lista hasta 30 fotos de la galería del producto, en el orden de la página.
* `description` es texto plano con una línea por párrafo, de hasta 10.000 caracteres; el texto que solo aparece dentro de imágenes no se incluye.
* `specs` lista hasta 100 pares `{ name, value }` de los detalles del producto.
* La lectura vuelve a ejecutar la consulta de la `url` en Google Shopping de su mercado, o el título del producto si Google ya no lo muestra para esa consulta, y abre el panel del producto, así que tarda más que la página de una tienda. Si Google no muestra el producto en ninguna de las dos, la tarea termina con `PAGE_UNAVAILABLE`.
* `offers` lista las tiendas que Google muestra para el producto, empezando por la que Google marca como el mejor precio, cada una con `seller`, `title` (el nombre del producto en la tienda), `url` (la página del producto en la tienda, cuando Google la enlaza), `price`, `listPrice`, `currency` e `inStock`. `price`, `listPrice`, `seller` e `inStock` del producto son los de la primera tienda. Los precios llevan la moneda de la pestaña Shopping del mercado (ISO 4217), sea cual sea el idioma de las etiquetas.
* Un `productDetailUrl` de un producto de Google AI Overviews o AI Mode busca el título del producto, y el resultado devuelve el `productDocid` de ese producto.

## Errores y facturación

* Una búsqueda que no devuelve productos termina como tarea fallida.
* Solo se cobran las tareas completadas: 2 créditos por búsqueda o página de producto.

## Relacionado

* [Google Search](https://docs.querying.ai/es/engines/google-serp.md)
* [Google AI Overviews](https://docs.querying.ai/es/engines/google-ai-overviews.md)
* [Google AI Mode](https://docs.querying.ai/es/engines/google-ai-mode.md)
* [Todas las tiendas de Commerce](https://docs.querying.ai/es/engines/overview.md#commerce)
* [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.