Search entities, people, and news
Runs the canonical entity, person, and news search engines sequentially and returns their typed result pages with per-scope strategy provenance. Supports only auto and keyword modes; unsupported modes are rejected before any scope runs. Page and size apply to every scope; cross-domain sort is not supported.
Authentication
User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key
Admin API key for system-to-system write operations
Client secret for read-only service-to-service access (no writes)
Query parameters
Zero-based page index (0..N)
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
Request
Plain-English search request.
Search strategy to run. Accepted values narrow per surface: entity and person natural-search take every value (exact is entity-only); news and federated search accept only auto and keyword; content search accepts only auto. Defaults to auto, which keeps the server-chosen pipeline; any other value forces exactly that strategy.
Optional chat model for planning; null uses the configured natural-search default. CLIENT_SECRET callers may only choose client-secret-eligible models; admin keys are unrestricted.
Response
Canonical entity natural-search result.
Canonical person natural-search result.