Search Custom
search_customRead-onlyIdempotent
Search the web via Google Custom Search, limit results to selected domains, and filter by date, language, country, or file type. Retrieve web or image results with customizable result counts.
Instructions
Performs a search using Google Custom Search JSON API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | The search query. Required. | |
| num | No | Number of results to return (1-10). Defaults to 10. | |
| safe | No | Safe search level. Defaults to "off". | off |
| sites | No | List of sites/domains to restrict search to (e.g., ["example.com", "docs.example.com"]). When provided, results are limited to these sites. | |
| start | No | The index of the first result to return (1-based). Defaults to 1. | |
| country | No | Country code for results (e.g., "countryUS"). | |
| language | No | Language code for results (e.g., "lang_en"). | |
| file_type | No | Filter by file type (e.g., "pdf", "doc"). | |
| search_type | No | Search for images if set to "image". | |
| site_search | No | Restrict search to a specific site/domain. | |
| date_restrict | No | Restrict results by date (e.g., "d5" for past 5 days, "m3" for past 3 months). | |
| user_google_email | Yes | The user's Google email address. Required. | |
| site_search_filter | No | Exclude ("e") or include ("i") site_search results. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |