File size: 3,322 Bytes
8cc894c 7953e73 8cc894c 7953e73 7514349 8cc894c 7953e73 7514349 7953e73 7514349 a279932 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 7953e73 7514349 a279932 7514349 7953e73 | 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 Search"
short_description: "Google results with titles, URLs, snippets and rankings."
emoji: "🔎"
colorFrom: "blue"
colorTo: "indigo"
sdk: "static"
app_file: "index.html"
pinned: false
license: "mit"
tags:
- smolagents
- tool
- flashdata
- google-search
---
# Google Search
Search Google and return ranked titles, URLs, snippets and positions as JSON. Filter by country, language, location or date, and request additional pages.
[API documentation](https://flashdata.dev/docs/sources/google_search?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google-search-agent-flashdata) · [Get an API key](https://flashdata.dev/signup?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_search-task) · [Pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_search-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-search-agent-flashdata", trust_remote_code=True)
result = tool(**{'gl': 'us', 'hl': 'en', 'num': 5, 'query': 'site:docs.langchain.com tool calling'})
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` | 10 | num minimum=1, maximum=100 |
| `page` | 1 | page minimum=1, maximum=100 |
| `autocorrect` | True | autocorrect |
| `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.organic`. Fields: `title`, `link`, `snippet`, `position`. 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
Returns search results, not webpage full text.
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_search-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.
|