API Google Shopping

Visão geralLink to Visão geral

Pesquise no Google Shopping e recupere listagens estruturadas com título, preço, comerciante, avaliação, ID de produto e URL. Localize com gl e hl, aponte para uma cidade com location ou uule, e pagine com page.

Principais casos de usoLink to Principais casos de uso

• Monitorizar preços de um produto entre comerciantes
• Comparar listagens e avaliações de concorrentes no Google Shopping
• Enriquecer um catálogo com preços de mercado e IDs de produto
• Descobrir os produtos melhor posicionados de uma categoria ou marca

Início rápidoLink to Início rápido

GET https://api.piloterr.com/v2/google/shopping?query=playstation+5&page=1&gl=br&hl=pt

GET e POST são suportados. Em GET, passe os parâmetros na query string. Em POST, envie os mesmos campos num body JSON.

POST https://api.piloterr.com/v2/google/shopping
Content-Type: application/json

{
  "query": "playstation 5",
  "page": 1,
  "gl": "br",
  "hl": "pt"
}

ParâmetrosLink to Parâmetros

RespostaLink to Resposta

• organic_results[]: cartões de produto (title, price, extracted_price, source, rating, reviews, product_id, product_link, thumbnail, position)
• search_parameters: eco dos parâmetros usados

NotasLink to Notas

• location e uule são mutuamente exclusivos
• Sem parâmetro num: cada página devolve cerca de 20 resultados
• Preços e rankings variam por país, idioma e momento