search_custom
Perform a Google Custom Search with configurable filters for site, date, file type, language, and images. Get ranked results with titles, links, and snippets.
Instructions
Performs a search using Google Custom Search JSON API.
Args: user_google_email (str): The user's Google email address. Required. q (str): The search query. Required. num (int): Number of results to return (1-10). Defaults to 10. start (int): The index of the first result to return (1-based). Defaults to 1. safe (Literal["active", "moderate", "off"]): Safe search level. Defaults to "off". search_type (Optional[Literal["image"]]): Search for images if set to "image". site_search (Optional[str]): Restrict search to a specific site/domain. site_search_filter (Optional[Literal["e", "i"]]): Exclude ("e") or include ("i") site_search results. date_restrict (Optional[str]): Restrict results by date (e.g., "d5" for past 5 days, "m3" for past 3 months). file_type (Optional[str]): Filter by file type (e.g., "pdf", "doc"). language (Optional[str]): Language code for results (e.g., "lang_en"). country (Optional[str]): Country code for results (e.g., "countryUS"). sites (Optional[List[str]]): List of sites/domains to restrict search to (e.g., ["example.com", "docs.example.com"]). When provided, results are limited to these sites.
Returns: str: Formatted search results including title, link, and snippet for each result.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | ||
| num | No | ||
| safe | No | off | |
| sites | No | ||
| start | No | ||
| country | No | ||
| language | No | ||
| file_type | No | ||
| search_type | No | ||
| site_search | No | ||
| date_restrict | No | ||
| user_google_email | Yes | ||
| site_search_filter | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |