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
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 com422 REGION_UNSUPPORTED.
include: até include: {} retorna 422 VALIDATION_ERROR em payload.include antes da reserva de créditos.
Exemplo de resposta
Campos do resultado
site,queryecountryrepetem a requisição.returnedCounté o número de itens emproducts.- Cada produto inclui
rank,productId,titleeurl.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.ranksegue a ordem padrão da loja, e os anúncios que a loja marca como patrocinados ficam de fora. price,rating,reviewCount,imageUrleselleraparecem quando a página de resultados os mostra.priceé um número nacurrencydo produto (ISO 4217); quando os tamanhos têm preços diferentes, é o menor.ratingusa uma escala de cinco pontos. Números de avaliações abreviados, como 999+, ficam de fora.reviewCountsó 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 essaurlaoCOMMERCE_PRODUCTpara 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. Aurlde 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}. OproductDetailUrlde um produto dos resultados de Google Search, Google AI Overviews e Google AI Mode também funciona como está.country: Opcional. O padrão é ogldaurl, um deUS,GB,AU,CA,KR,JP,TW,HK,DE,FR,ES,IT,PL,PT,BR,IN,ID,THeVN. Qualquer outro país é recusado com422 REGION_UNSUPPORTED.
include: até include: {} retorna 422 VALIDATION_ERROR em payload.include antes da reserva de créditos.
Exemplo de resposta
Campos do resultado
site,country,urleproductIdidentificam a página.urlé a página lida, eproductIdé o mesmo que uma busca retorna.titlesempre aparece.brand,price,listPrice,currency,inStock,seller,rating,reviewCount,images,description,specseoffersaparecem quando a página os mostra.priceé o que um comprador paga conforme a página mostra ao abrir, antes de cupons e frete, emcurrency(ISO 4217).listPriceé o preço normal que a página risca, presente quando é maior queprice.inStocké a disponibilidade do produto.selleré o lojista que o vende.ratingusa uma escala de cinco pontos com duas casas decimais.reviewCounté o número de avaliações.reviewCountsó aparece quando o Google mostra o número exato (abaixo de 1.000).imageslista 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.specslista até 100 pares{ name, value }dos detalhes do produto.- A leitura executa de novo a consulta da
urlno 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 comPAGE_UNAVAILABLE. offerslista as lojas que o Google mostra para o produto, começando pela que o Google marca como o melhor preço, cada uma comseller,title(o nome do produto na loja),url(a página do produto na loja, quando o Google a liga),price,listPrice,currencyeinStock.price,listPrice,sellereinStockdo 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
productDetailUrlde um produto do Google AI Overviews ou do AI Mode busca o título do produto, e o resultado retorna oproductDociddesse 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.