Search Google Shopping

POST/v1/tools/google.serp.shopping/callsNeeds an API key

Returns Google Shopping products for a query, with seller, price and rating. Use it to compare prices or check product rankings.

Tool google.serp.shopping on Google. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystringRequired

The product search query.

countrystring· default us

Two-letter ISO 3166-1 country code. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

languagestring· default en

Two-letter ISO 639-1 language code. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

locationstring

Place to search from, by name, such as "Austin, Texas".

pageinteger· default 1

Page of results, 40 per page.

At least 1.

min_pricenumber

Lowest price to include, in the currency of the country's storefront.

At least 0.

max_pricenumber

Highest price to include, in the currency of the country's storefront. Must not be below min_price.

At least 0.

Not less than min_price when both are sent.

autocorrectboolean

Whether Google may correct the spelling of the query.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`results`

A list of rows. Always present, possibly empty.

positionintegerRequired

Rank among shopping results, starting at 1.

titlestringRequired

urlstring

Address of the product's page on Google Shopping.

sellerstring

Name of the store selling the product.

pricestring

The price as Google shows it, with its currency symbol, such as "$19.99". Not parsed.

price_amountnumber

The price as a number, in the currency that price shows.

ratingnumber

Average review rating, out of 5.

review_countinteger

image_urlstring

Address of the product's thumbnail image.

product_idstring

Google's product cluster identifier. google.shopping.product takes it as product_id.

catalog_idstring

Google's catalog identifier of the product. Not the product_id that google.shopping.product takes.

deliverystring

Delivery terms as Google shows them, such as "Free delivery".

curl https://api.voxoria.ai/v1/tools/google.serp.shopping/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"standing desk","country":"us"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.serp.shopping/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"query": "standing desk", "country": "us"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/google.serp.shopping/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"query": "standing desk", "country": "us"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.serp.shopping",
    "input": {
      "query": "standing desk",
      "country": "us"
    }
  }
}

200 OKoutputapplication/json

{
  "results": [
    {
      "position": 1,
      "title": "FlexiSpot Electric Height Adjustable Standing Desk",
      "url": null,
      "seller": "FlexiSpot.com",
      "price": "$109.99",
      "price_amount": 109.99,
      "rating": 4.8,
      "review_count": 1700,
      "image_url": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSNpcl5DVUBQ-1Y-fKLb3cYCajHyc7hXiykiSwPNAAg_IZa3JvRZNLnjyldcqWGQFS4JM7XFoVkCNfgfAlMuOjViFQFsWCP8w",
      "product_id": "12076690216614034454",
      "catalog_id": "12366406237090414672",
      "delivery": "Free delivery by Sat"
    },
    {
      "position": 2,
      "title": "Sweetcrispy Electric Adjustable Height Standing Desk 24 inch Sit to Stand Up Desk with Splice Board",
      "url": null,
      "seller": "Lowe's",
      "price": "$109.99",
      "price_amount": 109.99,
      "rating": 1,
      "review_count": 1,
      "image_url": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcSnYWoTeqhrcTGnW7rmeP4iAYbC74F-Dhrd7jmwN5MujIAMUhXbMhahC_XZpwu95hz6EJ5TiqJ1d9rf_IWSZD1AbjJuRjotTMNLX3BK6xehQM1tnlK1Xhdk",
      "product_id": "6537558550646730696",
      "catalog_id": "11660662186877421712",
      "delivery": "Free delivery"
    },
    {
      "position": 3,
      "title": "Mainstays Electric Standing Desk",
      "url": null,
      "seller": "Walmart",
      "price": "$149.00",
      "price_amount": 149,
      "rating": 4.4,
      "review_count": 213,
      "image_url": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcQxAU3FONrLl0oNMX0MleSTAMmZMVRlrWxw_2ipM8GLCEwYQ-OIPPSkjQ2bdlx9vHQy4Sij5ipi2teTBKTQfGZLABCn8ScPOUGIlDVnXojzT_hFdRa7M_Y6",
      "product_id": "13373890562389985590",
      "catalog_id": "18050164508007971186",
      "delivery": "Free delivery"
    }
  ]
}

The output of a real call, each list cut to 3 items.