Search Custom
search_customRead-onlyIdempotent
Search the web or specific websites using Google Custom Search with filters for date, file type, language, and more. Provide query and Google email to get tailored results.
Instructions
Performs a search using Google Custom Search JSON API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_google_email | Yes | The user's Google email address. Required. | |
| q | Yes | The search query. Required. | |
| num | No | Number of results to return (1-10). Defaults to 10. | |
| start | No | The index of the first result to return (1-based). Defaults to 1. | |
| safe | No | Safe search level. Defaults to "off". | off |
| search_type | No | Search for images if set to "image". | |
| site_search | No | Restrict search to a specific site/domain. | |
| site_search_filter | No | Exclude ("e") or include ("i") site_search results. | |
| date_restrict | No | Restrict results by date (e.g., "d5" for past 5 days, "m3" for past 3 months). | |
| file_type | No | Filter by file type (e.g., "pdf", "doc"). | |
| language | No | Language code for results (e.g., "lang_en"). | |
| country | No | Country code for results (e.g., "countryUS"). | |
| 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. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |