Google Search
google_searchRead-only
Search the web and retrieve a list of URLs with titles and snippets. Use this to find relevant links for further processing.
Instructions
Search the web using Google Custom Search API. Returns a list of URLs with titles and snippets.
When to use:
You need URLs to process yourself (e.g., selective scraping)
You only need links without full content
You want to filter/choose which URLs to scrape
When to use search_and_scrape instead:
You need actual page content for research
You want content from multiple sources combined
Caching: Results cached for 30 minutes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query string. Use natural language or specific keywords for better results. More specific queries yield better results and more relevant sources. | |
| num_results | No | Number of search results to return (1-10). Higher numbers increase processing time and API costs. Use 3-5 for quick research, 8-10 for comprehensive coverage. | |
| time_range | No | Restrict results to a recent time range. 'day' = last 24 hours, 'week' = last 7 days, 'month' = last 30 days, 'year' = last 365 days. Omit for no time restriction. | |
| site_search | No | Limit results to a specific site (e.g., 'github.com', 'stackoverflow.com'). Useful for domain-specific research. | |
| site_search_filter | No | Whether to include or exclude results from site_search. 'include' (default) shows only results from the site, 'exclude' removes results from the site. | |
| exact_terms | No | Required exact phrase that must appear in all results. Useful for finding specific quotes or technical terms. | |
| exclude_terms | No | Terms to exclude from search results. Useful for filtering out irrelevant topics. Separate multiple terms with spaces. | |
| language | No | Restrict results to a specific language. Format: 'lang_XX' where XX is ISO 639-1 code (e.g., 'lang_en' for English, 'lang_es' for Spanish, 'lang_fr' for French). | |
| country | No | Restrict results to a specific country. Format: 'countryXX' where XX is ISO 3166-1 alpha-2 code (e.g., 'countryUS' for United States, 'countryGB' for United Kingdom). | |
| safe | No | Safe search filtering level. 'off' = no filtering, 'medium' = moderate filtering, 'high' = strict filtering. Defaults to Google's account settings if omitted. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | Yes | List of URLs returned by the search | |
| query | Yes | The search query that was executed | |
| resultCount | Yes | Number of URLs found |