Novidades22 de out. de 2026Novo

O Google Shopping já está disponível no Commerce Search e no Commerce Product

API

Google Shopping com as etiquetas COMMERCE_SERP e COMMERCE_PRODUCT, os três primeiros produtos de cerave moisturizing cream com preço, nota e loja, e as quatro lojas que o Google lista para o primeiro, da Target a US$ 4,19 à CVS Pharmacy a US$ 7,49

Pesquise a aba Shopping do Google nos EUA com o Commerce Search e leia qualquer produto com o Commerce Product para receber cada loja que o Google lista, com preço, estoque e página do produto.

O que você recebe

site: "google_shopping" no COMMERCE_SERP: uma tarefa pesquisa a aba Shopping do Google nos EUA e devolve até 40 produtos na ordem do Google, cada um com rank, productId, title, price e url.
seller: a loja que aparece em cada card, como Target, Ulta Beauty ou Walmart, junto de rating, reviewCount e imageUrl quando o card os mostra.
COMMERCE_PRODUCT lê qualquer produto desses resultados pela sua url e devolve title, price, seller, inStock, rating, images e specs.
offers: todas as lojas que o Google lista para o produto, cada uma com seller, title, price, currency, inStock e a url da própria página do produto.

Como funciona

Cada busca lê a aba Shopping que o Google mostra para a sua consulta nos EUA, a página de google.com/search?udm=28. A url de um produto abre essa página de resultados e leva o ID e o título do produto depois de #; é assim que o COMMERCE_PRODUCT encontra o mesmo produto de novo.

A leitura abre a página de resultados, clica no produto e lê o painel que o Google mostra: lojas, descrição, especificações e fotos. price, listPrice, seller e inStock do produto vêm da primeira loja, a que o Google marca como melhor preço. O Google reorganiza os resultados de buscas amplas ao longo do dia, então a leitura procura o produto primeiro pela consulta e depois pelo título.

reviewCount traz o número exato que o Google mostra, até 1.000; acima disso, o Google abrevia como 17K.

Onde ajuda

Veja qual loja tem o melhor preço do Google para o seu produto e quanto as outras lojas cobram a mais.
Acompanhe todo dia os produtos que o Google Shopping posiciona em uma busca de categoria, ao lado dos rankings da Amazon, Walmart e Target para a mesma consulta.
Reúna as páginas de produto de todas as lojas que vendem um item e leia a da Target, Walmart ou Ulta com o Commerce Product.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho 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 da requisição

taskTypestringObrigatório: O motor que executa a tarefa, como CHATGPT ou GOOGLE.
payload.sitestringObrigatório: A loja pesquisada, como amazon, coupang ou rakuten. Os 21 valores aparecem com o motor.
payload.querystringObrigatório: A busca, escrita como o comprador digita na caixa de busca da loja. De 1 a 500 caracteres.
payload.countrystring: O país da loja, como US para amazon ou KR para coupang. É também o valor padrão.
payload.limitinteger: Produtos retornados, de 1 a 40. Padrão 20.
webhook.urlstring: Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

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 e, no fim, COMPLETED com a resposta ou FAILED com error.
credits.creditsChargedinteger: Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.
response.returnedCountinteger: O número de produtos em products.
response.productsarray: Os produtos na ordem do Google: rank, productId, title, url, price, currency e seller, além de rating, reviewCount e imageUrl quando o card os mostra.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

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

Ler um produto

Passe a url de um produto dos resultados para o COMMERCE_PRODUCT. Esta é a leitura do primeiro produto acima, resumida.

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"
    }
  }'

taskTypestringObrigatório: O motor que executa a tarefa, como CHATGPT ou GOOGLE.
payload.urlstringObrigatório: A url de um produto de um resultado do Commerce Search com google_shopping. Ela abre a página de resultados e leva o ID e o título do produto depois de #.

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: O que o comprador paga pelo produto como a página o mostra primeiro, antes de cupons e frete, em currency (ISO 4217). listPrice é o preço normal riscado quando fica acima de price.
response.offersarray: As lojas que o Google lista para o produto, na ordem do Google: seller, title, price, currency e a url da página do produto na loja, além de listPrice e inStock quando a linha os mostra. A primeira loja é o melhor preço do Google.

Erros

VALIDATION_ERRORHTTP 422: site está fora das 21 lojas, query está vazio ou passa de 500 caracteres, limit está fora de 1 a 40 ou o payload traz outro campo. details indica o campo.
VALIDATION_ERRORHTTP 422: url está ausente, passa de 2.048 caracteres ou fica fora das páginas de produto das 18 lojas, ou o payload traz um campo diferente de url e country. details indica o campo.
REGION_UNSUPPORTEDHTTP 422: country é um país diferente do da loja, como KR com amazon.
MISSING_API_KEYHTTP 401: Falta o cabeçalho Authorization, ou a chave é desconhecida, expirou ou foi revogada.
INSUFFICIENT_CREDITSHTTP 402: O saldo é menor que o preço da tarefa. Adicione créditos ou mude de plano e envie de novo.

Preço

Cada busca concluída e cada leitura concluída usa 3 créditos, como nas demais lojas. Os créditos são cobrados quando a tarefa é concluída.

Mais novidades

API22 de out. de 2026Novo
Veja quanto da sua página o ChatGPT lê
Envie a URL de uma página ao GEO Score e receba quanto da página o ChatGPT search guarda, o que o ChatGPT recebe quando abre a página e a causa e a correção de cada parte que falta.
API22 de out. de 2026Novo
Conheça o Commerce Product
Envie a URL de uma página de produto do Google Shopping, da Amazon, Walmart, Sephora, Olive Young, Rakuten, Zalando ou de outras 11 lojas e receba preço, estoque, imagens da galeria e da descrição, especificações e opções no mesmo formato.

Receba atualizações do produto por e-mail.

Feed RSS