Saltar para o conteúdo principal
Busque produtos na loja Google Shopping (shopping.google.com) e leia as páginas de produto dela pela API de tarefas assíncronas. Envie COMMERCE_SERP com site google_shopping para receber os produtos que uma busca mostra, na ordem da loja, ou COMMERCE_PRODUCT com a url de um produto para ler esse produto. Cada busca ou página de produto concluída custa 2 créditos.

Busca

Envie a tarefa e depois consulte GET /v1/async/task/{id} ou receba o webhook. Veja Tarefas assíncronas.

Parâmetros

  • site: Obrigatório. google_shopping.
  • query: Obrigatório. Termo de busca, de 1 a 500 caracteres.
  • limit: Inteiro opcional de 1 a 40, com padrão 20.
  • country: Opcional. O padrão é US, o país da loja. Qualquer outro país é recusado com 422 REGION_UNSUPPORTED.
Só os campos de payload listados acima são aceitos. Omita include: até include: {} retorna 422 VALIDATION_ERROR em payload.include antes da reserva de créditos.

Exemplo de resposta

Campos do resultado

  • site, query e country repetem a requisição. returnedCount é o número de itens em products.
  • Cada produto inclui rank, productId, title e url. productId é o ID de produto do Google, ou o ID da oferta para um anúncio que o Google não agrupou em um produto. rank segue a ordem padrão da loja, e os anúncios que a loja marca como patrocinados ficam de fora.
  • price, rating, reviewCount, imageUrl e seller aparecem quando a página de resultados os mostra. price é um número na currency do produto (ISO 4217); quando os tamanhos têm preços diferentes, é o menor.
  • rating usa uma escala de cinco pontos. Números de avaliações abreviados, como 999+, ficam de fora. reviewCount só aparece quando o Google mostra o número exato (abaixo de 1.000).
  • Cada busca retorna produtos da primeira página de resultados da loja.
  • A página do Google não leva a nenhuma página de produto ou de lojista, então url é a página de resultados do Google Shopping em que o produto foi classificado, com #product={productId}&title={title} no final. Passe essa url ao COMMERCE_PRODUCT para ler as lojas, as especificações e a descrição do produto. seller é a loja que o Google mostra primeiro.

Página de produto

Parâmetros

  • url: Obrigatório. A url de um produto retornada por uma busca no Google Shopping, com até 2.048 caracteres: google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}. O productDetailUrl de um produto dos resultados de Google Search, Google AI Overviews e Google AI Mode também funciona como está.
  • country: Opcional. O padrão é o gl da url, um de US, GB, AU, CA, KR, JP, TW, HK, DE, FR, ES, IT, PL, PT, BR, IN, ID, TH e VN. Qualquer outro país é recusado com 422 REGION_UNSUPPORTED.
Só os campos de payload listados acima são aceitos. Omita include: até include: {} retorna 422 VALIDATION_ERROR em payload.include antes da reserva de créditos.

Exemplo de resposta

Campos do resultado

  • site, country, url e productId identificam a página. url é a página lida, e productId é o mesmo que uma busca retorna.
  • title sempre aparece. brand, price, listPrice, currency, inStock, seller, rating, reviewCount, images, description, specs e offers aparecem quando a página os mostra.
  • price é o que um comprador paga conforme a página mostra ao abrir, antes de cupons e frete, em currency (ISO 4217). listPrice é o preço normal que a página risca, presente quando é maior que price. inStock é a disponibilidade do produto. seller é o lojista que o vende.
  • rating usa uma escala de cinco pontos com duas casas decimais. reviewCount é o número de avaliações. reviewCount só aparece quando o Google mostra o número exato (abaixo de 1.000).
  • images lista até 30 fotos da galeria do produto, na ordem da página.
  • description é texto simples com uma linha por parágrafo, com até 10.000 caracteres; o texto que só aparece dentro de imagens não é incluído.
  • specs lista até 100 pares { name, value } dos detalhes do produto.
  • A leitura executa de novo a consulta da url no Google Shopping do mercado dela, ou o título do produto quando o Google não o mostra mais para a consulta, e abre o painel do produto; por isso leva mais tempo que a página de uma loja. Se o Google não mostrar o produto em nenhuma das duas, a tarefa termina com PAGE_UNAVAILABLE.
  • offers lista as lojas que o Google mostra para o produto, começando pela que o Google marca como o melhor preço, cada uma com seller, title (o nome do produto na loja), url (a página do produto na loja, quando o Google a liga), price, listPrice, currency e inStock. price, listPrice, seller e inStock do produto são os da primeira loja. Os preços vêm na moeda da aba Shopping do mercado (ISO 4217), seja qual for o idioma dos rótulos.
  • Um productDetailUrl de um produto do Google AI Overviews ou do AI Mode busca o título do produto, e o resultado retorna o productDocid desse produto.

Erros e cobrança

  • Uma busca que não retorna produtos termina como tarefa com falha.
  • Só as tarefas concluídas são cobradas: 2 créditos por busca ou página de produto.

Relacionado