Google Shopping search

Live Google Shopping listings for a query: product title, merchant, price, product id, image URL, the listing link and the position it held, localized by country and language, with pagination.

Use to compare prices for a product across merchants, to watch how a listing ranks on Google Shopping, or to snapshot what a category sells for in a given country. Use amazon.search when you only care about Amazon.

Price

$0.0105 per result. That is the rate you pay for each result the call returns, so the total depends on how many it produces. Billing follows actual usage, so a call that returns fewer results costs less. discover and inspect also return a ceiling for your specific request, which is a maximum you will never be charged above.

Input

Field	Type	Required	Notes
`num`	`10`, `20`, `30`, `40`, `50`, `100`		COSTS EXTRA. Results requested per page. Google returns roughly double this and stops near 40, and every returned listing is billed. Defaults to `"10"`.
`query`	`string`	yes	The product or category to search for, for example “running shoes”.
`country`	`string`		Two letter country code to search in, for example us, gb, de, fr, ro. Defaults to `"us"`.
`queries`	`array`		Overrides query when present. Limited to one entry: send one call per query so the price stays proportional to the request.
`language`	`string`		Two letter language code, for example en, de, fr, es, ro. Defaults to `"en"`.
`max_pages`	`integer`		COSTS EXTRA, linearly. Pages to scrape. This is the field the price is sized on. Defaults to `1`.
`date_range`	`anytime`, `qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`		Restrict to listings seen in the last hour, day, week or month. Defaults to `"anytime"`.

Goro forwards your input to the underlying tool unchanged, so any field the tool accepts works here even if it is not listed above.

Example

curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"shopping.search","input":{"query":"example","max_pages":3}}'

Response

One row of the response. Values are illustrative.

{
  "link": "https://www.google.com/search?ibp=oshop&q=running+shoes&prds=productid:16078491969622180360&gl=us&udm=28",
  "price": "$150.00",
  "query": "running shoes",
  "title": "Nike Air Max 270 Men's Shoes",
  "source": "Nike.com",
  "imageUrl": "https://example.com/media/sample.jpg",
  "position": 1,
  "productId": "16078491969622180360"
}

Guide

CLI reference

API reference

Tools

Google Shopping search

Price

Input

Example

Response

​Price

​Input

​Example

​Response

Price

Input

Example

Response