Guide
Automatic versus explicit provider search
Choose automatic selection for provider-agnostic search or explicit selection for account-controlled provider calls.
Automatic search
POST /api/v1/search selects locally eligible providers from generic search capabilities. It prefers account credentials and may use permitted platform credentials in production. Result items omit provider-source attribution while top-level diagnostics remain available.
Explicit provider search
POST /api/v1/search_providers uses only account-supplied provider credentials. Callers may list canonical provider IDs or omit the list to use every provider with an available account credential.
Selection rule
Use automatic search when the caller should not choose providers. Use explicit search when provider identity, account-owned credentials, or attributed comparison is part of the workflow.