Tools

Google Shopping tools

Google Shopping results, product specs, every store's price and pooled reviews.

See what Google Shopping shows for a search, what each store charges for a product, its specs, and the reviews pooled from the stores that sell it. Results are read live and can take up to a minute.

shopping_search_products returns three ids on every row: product_id, gid and data_docid. Pass all three to shopping_get_product, shopping_get_sellers and shopping_get_reviews; Google finds a product most reliably with all of them.

To compare prices, run shopping_search_products for the product, then shopping_get_sellers on the row that matches it.

To connect these tools to your agent, see the Google Shopping MCP page.

Tool	What it does	Cost
`shopping_search_products`	Search Google Shopping	From 1 credit
`shopping_get_product`	Get a Shopping product	From 1 credit
`shopping_get_sellers`	Compare a product's prices	From 2 credits
`shopping_get_reviews`	Get product reviews	From 1 credit

Search Google Shopping

Toolshopping_search_products

Google Shopping results for a search: products in order with store, price, previous price, rating and delivery, plus the ids the other shopping_* tools take.

Good for

"what does Google Shopping show for X", "which stores win Shopping for our product", "what do competitors charge".

Not the tool for

Amazon, use amazon_search_products.
Google web results, use seo_get_serp.

What you get

One record with keyword, Each row has rank, product_id, gid, data_docid, title, seller, price, old_price, currency, rating, ratings_count, tags[], delivery, url. Google's grouped carousels are left out.

Cost

1 credit per 40 results. Default 40 = 1 credit. Cached 1 day. Can take up to a minute.

Parameters

Parameter	Default and notes
`keyword`	Required
`depth`	40, max 120; billed per 40
`location`	"United States"
`language`	"en"

It also takes the common parameters provider, max_credits and dry_run.

Example input

{
  "keyword": "standing desk"
}

Get a Shopping product

Toolshopping_get_product

One Google Shopping product: description, specs, images, rating and its offers from each store.

Good for

"what specs does Google list for this product", "how is it described and rated across stores".

Not the tool for

The full store list with shipping and tax, use shopping_get_sellers.
Reviews, use shopping_get_reviews.

What you get

One record with product_id, gid, data_docid, title, description, url, images[], rating, ratings_count, specs[] (group, name, value), offers[] (seller, url, price, regular_price, currency, seller_rating, seller_ratings_count, availability).

Cost

1 credit. Cached 1 day. Can take up to a minute.

Parameters

Parameter	Default and notes
`product_id`	Required
`location`	"United States"
`language`	"en"

gid and data_docid (pass all three from shopping_search_products).

It also takes the common parameters provider, max_credits and dry_run.

Example input

{
  "product_id": "13896795030841728717",
  "gid": "12076690216614034454",
  "data_docid": "10381679383724335789"
}

Compare a product's prices

Toolshopping_get_sellers

Every store selling one Google Shopping product, with base price, shipping, tax, total and the store's rating: a price comparison.

Good for

"who sells this cheapest", "is anyone undercutting us", "which retailers carry our product".

Not the tool for

The product's specs, use shopping_get_product.
Amazon's sellers, use amazon_get_sellers.

What you get

One record with product_id, title, Each row has rank, seller, domain, url, price, shipping, tax, total_price, currency, seller_rating, seller_ratings_count, condition, availability, note.

Cost

2 credits. Cached 6 hours. Can take up to a minute.

Parameters

Parameter	Default and notes
`product_id`	Required
`location`	"United States"
`language`	"en"

gid and data_docid (pass all three from shopping_search_products).

It also takes the common parameters provider, max_credits and dry_run.

Example input

{
  "product_id": "13896795030841728717",
  "gid": "12076690216614034454",
  "data_docid": "10381679383724335789"
}

Get product reviews

Toolshopping_get_reviews

Reviews of one Google Shopping product pooled from the stores that sell it, with the count at each star rating.

Good for

"what do buyers say about this product", "what do 1-star reviews of competitor's product complain about".

Not the tool for

App reviews, use apps_get_reviews.
Amazon reviews: not available.

What you get

One record with product_id, title, rating, ratings_count, stars[] (stars, count), Each row has rating, title, text, author, source (the store the review came from), published_at.

Cost

5 credits per 100 reviews. Default 100 = 5 credits. Cached 7 days. Can take up to a minute.

Parameters

Parameter	Default and notes
`data_docid`	Pass it from `shopping_search_products`
`limit`	100, max 1000; returned in tens
`location`	"United States"
`language`	"en"

product_id and gid (required).

It also takes the common parameters provider, max_credits and dry_run.

Example input

{
  "product_id": "13896795030841728717",
  "gid": "12076690216614034454",
  "limit": 50
}