What is Google Shopping Search?
Find products on Google Shopping and compare the listed prices and sellers. Start with a category or model to build a shortlist of offers worth opening.
Keep the exact model clear when comparing listings with similar names. The result list is useful for researching a category’s price range or finding sellers offering the same item.
Settings Google Shopping Search takes
You describe the task in plain words and your AI assistant fills these in. In code you pass them yourself.
| Setting | What it controls | Tip |
|---|---|---|
| Query | Product query, up to 2,048 characters. Optional when a shoprs token is supplied. | Optional · up to 2048 characters |
| Country | Two-letter country code for result localization, such as 'us'. | Optional |
| Language | Interface and result language, such as 'en', 'en-GB', or 'de'. Default 'en'. | Optional · up to 32 characters |
| Num | Number of products to return, 1-100; Google's 40-product pages are consumed for you. | Optional · 1 to 100 |
| Uule | Pre-encoded Google location token. Conflicts with location. | Optional · up to 2048 characters |
| Start | Result offset, 0-1,000. Default 0. | Optional · 0 to 1000 |
| Device | Device layout Google renders. Default 'desktop'. | Optional · one of desktop, tablet, mobile |
| Shoprs | Refinement token from a previous response's filters. An explicit refinement replaces the one it carries. | Optional · up to 4096 characters |
| On sale | Only products Google marks as on sale. Excludes the other refinements. | Optional |
| Sort by | '1' price low to high, '2' price high to low, '3' rating high to low, '4' relevance. Combines with one refinement. | Optional · one of 1, 2, 3, 4 |
| Location | Human-readable search origin, such as 'Austin, Texas'. Conflicts with uule. | Optional · up to 512 characters |
| Max price | Upper price bound, at or above min_price. Excludes the other refinements. | Optional |
| Min price | Lower price bound. Excludes the other refinements. | Optional |
| Free shipping | Only products with free shipping. Excludes the other refinements. | Optional |
| Google domain | Google domain to query, such as 'google.com' or 'google.co.uk'. Default 'google.com'. | Optional |
| Small business | Only products from small businesses. Excludes the other refinements. | Optional |
How to use Google Shopping Search with your AI assistant
Connect AI/ML API
Click Try it now, pick your client and add the MCP server. You sign in with your AI/ML API account once.
Describe the task
Say what you need in one sentence.
Get the result
Your assistant runs Google Shopping Search and shows what came back.
Keep going in the chat
Ask it to filter, compare or summarize the result, or to save it as a table.
Ways to use it
- For a buying shortlist: compare the products and sellers appearing for a shopping query before choosing listings to investigate.
Google Shopping Search in your code
In your code
REST · your AI/ML API key, JSON records back
The same tool runs over REST with your AI/ML API key, so a backend, a script or a scheduled job can call Google Shopping Search directly. Start with the Toolbox REST quickstart.
Pricing
Pay as you goBilled per run from your AI/ML API balance
- No subscription
- No seat fee
- One balance for every tool
Each run is billed from your AI/ML API balance, with no subscription or seat fee. Check the current price in your dashboard before large runs.
FAQ
Do I need a separate account for Google Shopping Search?
No. It runs on your AI/ML API account and balance, from your AI assistant over MCP or from your code over REST.
Which AI assistants can use it?
Claude, ChatGPT, Cursor, Hermes, OpenClaw and other MCP clients. Add the AI/ML API MCP server once with the MCP quickstart.
Run Google Shopping Search from your assistant
Connect once, then ask for it in plain words.