API de Google Shopping

Descripción generalLink to Descripción general

Busca en Google Shopping y recupera listados estructurados con título, precio, comerciante, valoración, ID de producto y URL. Localiza con gl y hl, apunta a una ciudad con location o uule, y pagina con page.

Casos de uso principalesLink to Casos de uso principales

• Supervisar precios de un producto entre comerciantes
• Comparar fichas y valoraciones de competidores en Google Shopping
• Enriquecer un catálogo con precios de mercado e IDs de producto
• Descubrir los productos mejor posicionados de una categoría o marca

Inicio rápidoLink to Inicio rápido

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

GET y POST están soportados. En GET, pasa los parámetros en query string. En POST, envía los mismos campos en un body JSON.

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

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

ParámetrosLink to Parámetros

RespuestaLink to Respuesta

• organic_results[]: fichas de producto (title, price, extracted_price, source, rating, reviews, product_id, product_link, thumbnail, position)
• search_parameters: eco de los parámetros usados

NotasLink to Notas

• location y uule son mutuamente excluyentes
• No hay parámetro num: cada página devuelve unos 20 resultados
• Precios y rankings varían por país, idioma y momento