Skip to content
Poshuk
Menu

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.