Skip to content

Search: Shopping

Product listings with parsed prices and structured ratings. Use it for product intelligence, price comparison, and merchant research.
const page = await google('macbook pro', { type: 'shopping' })

Result fields

FieldTypeDescription
titlestringProduct name
urlstringMerchant URL
publisherstringMerchant or retailer name
price{ symbol, amount }Parsed price with currency symbol and numeric amount
image{ url }?Product image
rating{ score, total, reviews? }?Rating with score, total (scale), and review count
idstring?Product identifier
const page = await google('macbook pro', { type: 'shopping' })

page.results[0]
// {
//   title: '14-inch MacBook Pro Apple M5 chip CPU and GPU',
//   url: 'https://www.google.com/search?ibp=oshop&q=macbook+pro&prds=...',
//   publisher: 'Apple',
//   price: { symbol: '$', amount: 1699 },
//   rating: { score: 4.8, total: 5, reviews: 2400 },
//   id: '1293272249390991376'
// }
Prices are already parsed into numeric amount values — no need to strip currency strings in your pipeline:
const page = await google('macbook pro', { type: 'shopping' })

const affordable = page.results.filter(r => r.price.amount < 500)
const avgPrice = page.results.reduce((sum, r) => sum + r.price.amount, 0) / page.results.length

See also

  • Web Search — when you need general web results instead of product listings.
  • Integration patterns — product intelligence and price monitoring workflows.