google_search
Perform Google searches programmatically using the official API with automatic key rotation, intelligent quota management, and advanced filters like language, geolocation, SafeSearch, and file type to retrieve precise results.
Instructions
Performs Google searches using the official API with automatic API key rotation.
Features:
- Official Google Web Search
- Automatic API key rotation
- Intelligent quota management
- Multi-language and geolocation support
Parameters:
- query: Search query (required)
- num: Number of results (1-10, default: 5)
- start: Starting index (default: 1)
- safe: SafeSearch (off/active, default: off)
- lr: Language (ex: lang_fr, lang_en)
- gl: Country (ex: fr, us, uk)
Returns a JSON list of results with title, link, description and domain.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cr | No | Country restriction (ex: countryFR, countryUS) | |
| dateRestrict | No | Time filter (ex: d1=24h, w1=week, m1=month, y1=year) | |
| exactTerms | No | Exact phrase required | |
| excludeTerms | No | Words to exclude from search | |
| fileType | No | File type (ex: pdf, doc, ppt) | |
| gl | No | Geolocation (country code: fr, us, uk, etc.) | |
| lr | No | Results language (ex: lang_fr, lang_en) | |
| num | No | Number of results to return (1-10) | |
| orTerms | No | Alternative terms (OR) | |
| query | Yes | Google search query | |
| rights | No | License filters (ex: cc_publicdomain) | |
| safe | No | SafeSearch level | |
| searchType | No | Search type (value: image) | |
| siteSearch | No | Search specific site (ex: reddit.com) | |
| siteSearchFilter | No | Include (i) or exclude (e) the site | |
| sort | No | Sort by date (value: date) | |
| start | No | Starting index of results |