flashdata-dev's picture
Track FlashData signup and pricing referrals
a279932 verified
|
Raw History Blame Contribute Delete
3.32 kB
---
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.