google_search
Perform Google searches using the official API with automatic key rotation, intelligent quota management, and advanced filtering options. Supports multi-language, geolocation, and SafeSearch for tailored 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 |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cr": {
"description": "Country restriction (ex: countryFR, countryUS)",
"type": "string"
},
"dateRestrict": {
"description": "Time filter (ex: d1=24h, w1=week, m1=month, y1=year)",
"type": "string"
},
"exactTerms": {
"description": "Exact phrase required",
"type": "string"
},
"excludeTerms": {
"description": "Words to exclude from search",
"type": "string"
},
"fileType": {
"description": "File type (ex: pdf, doc, ppt)",
"type": "string"
},
"gl": {
"description": "Geolocation (country code: fr, us, uk, etc.)",
"type": "string"
},
"lr": {
"description": "Results language (ex: lang_fr, lang_en)",
"type": "string"
},
"num": {
"description": "Number of results to return (1-10)",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"orTerms": {
"description": "Alternative terms (OR)",
"type": "string"
},
"query": {
"description": "Google search query",
"type": "string"
},
"rights": {
"description": "License filters (ex: cc_publicdomain)",
"type": "string"
},
"safe": {
"description": "SafeSearch level",
"enum": [
"off",
"active"
],
"type": "string"
},
"searchType": {
"description": "Search type (value: image)",
"type": "string"
},
"siteSearch": {
"description": "Search specific site (ex: reddit.com)",
"type": "string"
},
"siteSearchFilter": {
"description": "Include (i) or exclude (e) the site",
"enum": [
"i",
"e"
],
"type": "string"
},
"sort": {
"description": "Sort by date (value: date)",
"type": "string"
},
"start": {
"description": "Starting index of results",
"minimum": 1,
"type": "integer"
}
},
"required": [
"query"
],
"type": "object"
}