Tasks
Web Search
Search the web and return a list of relevant results with page content.
Basic usage
Parameters
search_query required string
The search query to run.
search_type string
The type of search to perform. One of:
auto— automatically selects the best search strategydeep— thorough search, best for comprehensive resultsfast— optimised for speedinstant— fastest option, best for simple lookups
Default: auto
filters Object
Optional filters to narrow down search results.
Show child attributes
include_domains Array.<string>
Only return results from these domains. Example: ["bbc.com", "reuters.com"]
exclude_domains Array.<string>
Exclude results from these domains. Example: ["reddit.com"]
start_published_date string
Only return results published after this date.
Accepted formats: YYYY-MM-DD, YYYY-MM-DDTHH:mm, or ISO 8601.
end_published_date string
Only return results published before this date.
Accepted formats: YYYY-MM-DD, YYYY-MM-DDTHH:mm, or ISO 8601.
result_options Object
Options to control the result set.
Show child attributes
result_count number
The number of results to return. Must be between 1 and 100.
Default: 10
ai_summary Object
When enabled, each result will include an AI-generated summary based on the provided prompt.
Show child attributes
enabled required boolean
Whether to enable AI summary generation per result.
prompt required string
The prompt used to generate the summary for each result. Required when enabled is true.
Result
Properties
search_results Array.<Object>
Array of search result objects.
Show child attributes
id string
The unique identifier for the result (typically the URL).
title string
The title of the page.
url string
The URL of the page.
publishedDate string
The published date of the page in ISO 8601 format, if available.
author string
The author of the page, if available.
text string
The extracted text content of the page.
image string
The URL of the page's primary image (e.g. Open Graph image), if available.
favicon string
The URL of the page's favicon, if available.
summary string
AI-generated summary for this result. Only present when result_options.ai_summary.enabled is true.
Examples
Search with domain filter
Only return results from specific AI-focused publications.
Search with date range
Only return results published within a specific time window.
Search with AI summary
Return results with an AI-generated summary per page, tailored to your use case.
Result: