google_search
Search the web using Google Programmable Search. Get structured results including URL, title, and snippet. Filter by date, site, language, file type, and more.
Instructions
Performs a Google Programmable Search (CSE) query. Returns a JSON list of results, each containing a URL, title, snippet, and pagemap.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query. | |
| num | No | Number of results to return (1-10). | |
| start | No | The starting index of the results (1-based). For example, `&start=11` would start at the 11th result. | |
| dateRestrict | No | Restricts results to a time period. Format: `d[number]`, `w[number]`, `m[number]`, `y[number]` (days, weeks, months, years). Example: `d7` for the last 7 days. | |
| siteSearch | No | Restricts results to a specific site. Example: `wikipedia.org`. | |
| siteSearchFilter | No | Whether to include (`i`) or exclude (`e`) results from the `siteSearch` domain. | |
| exactTerms | No | A phrase that all search results must contain. Example: "climate change" | |
| excludeTerms | No | A word or phrase that should not appear in any search results. Example: `politics` | |
| fileType | No | Restricts results to files of a specific extension. Example: `pdf` | |
| gl | No | Geolocation of the end user. A two-letter country code. Example: `us` for United States. | |
| lr | No | Restricts the search to documents written in a particular language. Example: `lang_en` for English. | |
| safe | No | Search safety level. `active` or `off`. | active |
| searchType | No | Specifies the search type. Set to `image` for image search. | |
| sort | No | Sorts results by a specific attribute. Format: `TYPE-NAME:DIRECTION`. Example: `metatags-pubdate:d` to sort by publication date in descending order. |