Search the web
Returns ranked results from one serving provider. The default strategy selects a provider that supports the requested options. The fallback strategy tries providers in the supplied order. Results are not blended across providers. Portable filters may be approximated or omitted according to provider capabilities; warnings describe those outcomes unless strict_params is true. Native options apply only to their selected provider.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Primary search query. A provider-native multi-query option applies only to that provider; other providers in a fallback chain receive this query.
1 - 2048Optional portable content retrieval. Pass true for defaults or an options object. Omission never starts Kernel browser work; provider-supplied content is still returned when available, including when requested through native options. Both inline and deferred retrieval use the same options schema.
true ISO 3166-1 alpha-2 search locale preference.
^[A-Za-z]{2}$Inclusive publication-date upper bound; must not precede start_date. If recency is also supplied, recency takes precedence with a warning. Unsupported or approximated filtering is reported, or rejected under strict_params.
Hostname exclusions, with the same best-effort/strict behavior as include_domains. Provider-specific combinations that cannot be represented are reported via warnings or rejected in strict mode.
100Hostname inclusion preference, matching a hostname and its subdomains. Empty means unrestricted. Translated, emulated, or dropped with a warning according to provider capability unless strict_params is true. Native boost modes remain advisory and are identified in warnings.
100Include untouched per-result payloads and the full serving-provider response in raw fields. Off by default; native top-level outputs such as answer remain available without it.
BCP 47 search language preference.
Requested result count from 1 through 100. The effective count is clamped to the serving provider's cap with a warning. Effective native counts are the lower of this limit and supplied provider-native count aliases. Strict mode rejects unsupported counts.
1 <= x <= 100Relative search window. Takes precedence over start_date/end_date with a warning if both are set. Provider-native recency behavior is retained, including documented hour-to-day widening. Unsupported filters are rejected only in strict mode.
hour, day, week, month, year Optional safety preference. Omit to use provider defaults. Unsupported values are dropped with a warning unless strict_params is true. A search filter is not an authorization boundary.
off, moderate, strict Inclusive publication-date lower bound. If recency is also supplied, recency takes precedence with a warning. Provider date semantics, precision, and unsupported filters are reported; unknown source dates are not fabricated or universally post-filtered.
Omitted strategy defaults to auto.
- Option 1
- Option 2
- Option 3
When false, unsupported portable parameters are omitted and approximations are described in warnings. When true, every supplied portable parameter must be honored exactly. Requests that cannot be served with those parameters are rejected. This does not guarantee identical rankings or document timestamps across indexes. Authentication and project isolation are always enforced.
Overall deadline across search attempts and inline retrieval. No new attempt starts after the deadline. Completed search results survive inline retrieval timeouts.
1000 <= x <= 120000Response
Completed search, including valid zero-result responses. Inline retrieval failures are reported per result. Arrays are never null.
Retained search results and provider attempt history.
Expiration of result IDs for deferred retrieval. Results expire 24 hours after search completion.
Search resource ID. Request tracing uses X-Request-Id.
"srch_abc123"
Concrete serving provider, never auto or fallback.
Echo of the query. Native multi-query inputs are visible in the selected strategy target and the optional raw response.
Provider-generated answer when requested (e.g. via Tavily include_answer or Perplexity). Preserved independently of include_raw.
Full serving-provider response, including top-level metadata that does not belong to a result. Present only with include_raw=true; untrusted provider data.