Custom Search
AI-generatedSummary
Perform a web search using Google's Programmable Search Engine with specified query and optional filters, returning either all matching results or a limited number.
Inputs
- Search Query (required) — The query string to search for.
- Return All — Whether to return all available search results or only up to a specified limit.
- Limit — When 'Return All' is false, the maximum number of search results to return (minimum 1). Defaults to 50.
- Additional Fields — Optional parameters to refine the search, including exact terms, excluded terms, file type, image filters (color type, dominant color, size, type), site search filters, date restrictions, search safety level, sorting, search type, and others.
Output shape
An array of search result items, each item containing JSON with information for one matching search result.
If 'Return All' is enabled, the node paginates through results until all are retrieved; otherwise, it fetches results up to the specified 'Limit'. The results format follows the Google Custom Search API structure.
Examples
Example 1: Search for images of cats with all results
Set 'Search Query' to 'cats', enable 'Return All', leave other fields as default to retrieve all image results.
Example 2: Search for documents with specific exact terms and a limit
Set 'Search Query' to your base query, specify 'Exact Terms' in 'Additional Fields', set 'Return All' to false, and 'Limit' to desired count to get limited filtered results.