File size: 3,433 Bytes
f051159
6a9e4b9
 
 
 
 
 
 
f051159
6a9e4b9
56f3bf3
 
 
 
 
f051159
 
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
e78d2bb
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
 
 
56f3bf3
 
 
 
 
6a9e4b9
56f3bf3
 
 
 
 
 
 
 
 
 
 
 
6a9e4b9
56f3bf3
 
 
6a9e4b9
 
 
 
 
 
 
 
 
 
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
6a9e4b9
56f3bf3
e78d2bb
56f3bf3
6a9e4b9
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
---
title: "Google Shopping Search"
short_description: "Product listings with prices, merchants and offer links."
emoji: "🔎"
colorFrom: "blue"
colorTo: "indigo"
sdk: "static"
app_file: "index.html"
pinned: false
license: "mit"
tags:
  - smolagents
  - tool
  - flashdata
  - google-shopping
---

# Google Shopping Search

Search Google Shopping for product listings, merchant names, displayed prices and offer links. Choose a country to compare listings in that market.

[API documentation](https://flashdata.dev/docs/sources/google_shopping?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google-shopping-shortlist-flashdata) · [Get an API key](https://flashdata.dev/signup?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_shopping-task) · [Pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_shopping-task)

Requires your own FlashData API key and paid Credits. The Python tool is free to install.

## Try the inputs

Edit the JSON in this Space, generate a Python call, and inspect the included sample response or paste your own JSON. This page runs locally in your browser; it does not run a data query or collect your API key.

## Run with Python

Use Python 3.10 or newer:

```sh
python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1"
```

Review [tool.py](tool.py) before enabling `trust_remote_code`. Run locally with your key:

```python
import getpass
import os
from smolagents import load_tool

os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")
tool = load_tool("flashdata-dev/google-shopping-shortlist-flashdata", trust_remote_code=True)
result = tool(**{'gl': 'us', 'num': 10, 'query': '27 inch USB C monitor'})
print(result)
```

The same loaded tool can be used with smolagents. A direct Python call does not require a model.

## Inputs

| Parameter | Required / default | Details |
| --- | --- | --- |
| `query` | Required | Search query, between 1 and 2,000 characters. |
| `num` | None | Requested result count. minimum=1, maximum=100 |
| `page` | None | Search result page. minimum=1, maximum=100 |
| `autocorrect` | None | Enable spelling autocorrection. |
| `gl` | None | Two-letter country code, for example us. |
| `hl` | None | Interface language code, for example en. |
| `location` | None | Optional geographic search location. |
| `tbs` | None | Optional Google time filter, for example qdr:w. |

See [input-schema.json](input-schema.json) for full validation rules. Optional `None` values are omitted; adapter defaults apply.

## Output

Read `results.0.shopping`. Fields: `title`, `source`, `price`, `link`, `rating`. Optional fields may be absent.

[example.json](example.json) contains a recorded response and its original request, not a new result for the input shown in the Space.

## Limits and cost

Prices are listing snapshots. Stock, shipping and final checkout prices can differ.

Each data request uses FlashData Credits. Check [current pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_shopping-task) before running. Any model or hosting charges are separate.

For an uncertain timeout, check your FlashData Jobs before retrying; this tool does not automatically retry paid submissions.