Use case
Compare search providers through one API
Run the same query across selected providers and inspect normalized, attributed outcomes.
Explicit selection
The search_providers endpoint accepts canonical provider IDs and uses only credentials supplied by the account. Known providers that cannot run are reported instead of silently replaced.
Comparable output
Normalization gives each adapter a shared result shape. Raw mode keeps explicit results grouped by provider, while grouped and ranked modes combine comparable results.
Visible differences
Provider attribution and typed outcomes make coverage, failures, timeouts, and skipped providers visible without claiming that every provider uses the same index or ranking method.