Tasks
Web Search
Searches the web and returns relevant results with optional AI-generated summaries
Basic usage
Search the web and return the top 10 results.
Parameters
search_query required string
The search query to execute.
result_count optional string
The number of results to return.
Default: 10
settings optional object
Configuration settings for the web search.
Show child attributes
include_domains optional Array
Array of domains to include in the search results. Only results from these domains will be returned.
exclude_domains optional Array
Array of domains to exclude from the search results. Results from these domains will be filtered out.
start_published_date optional string
Start date for published content in ISO 8601 format (e.g., 2026-01-01T00:00:00.000Z).
end_published_date optional string
End date for published content in ISO 8601 format (e.g., 2026-12-31T23:59:59.999Z).
type optional string
Search type to use. Options are "auto", "neural", or "keyword".
Default: "auto"
ai_summary optional object
AI summary generation settings.
Show child attributes
enabled optional boolean
Whether to enable AI summary generation for each search result.
Default: false
prompt optional string
Custom prompt to use for the LLM when generating summaries.
Result
Properties
results Array
An array of search result objects.
results.id string
Unique identifier for the search result (typically the URL).
results.title string
The title of the search result.
results.url string
The URL of the search result.
results.publishedDate string
ISO 8601 timestamp of when the content was published. (if available)
results.author string
The author of the content (if available).
results.summary string
AI-generated summary of the content. Only present when settings.ai_summary.enabled is set to true.
results.image string
URL to a preview image for the content (if available).
results.favicon string
URL to the website's favicon (if available).
Examples
Searching with domain filters
Limit search results to specific trusted domains:
Result
Searching with AI summaries enabled
Enable AI-generated summaries for each search result:
Result
Searching within a date range
Search for content published within a specific time period:
Result
Excluding specific domains
Search while excluding certain domains from the results:
This example uses domain exclusion to filter out forums and focus on official documentation and tutorial sources.
Result
Using different search types
Use keyword-based search for more literal matching: