Search
The Search resource (client.search) provides multi-entity discovery across the Qarion platform. You can search within a single space or across all spaces in an organization. Results span products, issues, meetings, connectors, source systems, contracts, users, and comments — all returned in a unified SearchResult model with a type discriminator.
Methods
search(space_slug, query)
Search across all entity types within a single space.
| Parameter | Type | Description |
|---|---|---|
space_slug | str | Space identifier |
query | str | Search query (minimum 2 characters) |
Returns: list[SearchResult]
results = await client.search.search("marketing-analytics", "revenue")
for result in results:
print(f"[{result.type}] {result.name}")
Each result includes the type field so you can branch on entity kind:
results = await client.search.search("marketing-analytics", "pipeline")
products = [r for r in results if r.type == "product"]
issues = [r for r in results if r.type == "issue"]
meetings = [r for r in results if r.type == "meeting"]
search_organization(org_slug, query)
Search across all spaces the user has access to within an organization. Results are aggregated and capped per entity type to ensure balanced discovery.
| Parameter | Type | Description |
|---|---|---|
org_slug | str | Organization identifier |
query | str | Search query (minimum 2 characters) |
Returns: list[SearchResult]
results = await client.search.search_organization("acme-corp", "revenue")
for result in results:
print(f"[{result.type}] {result.name}: {result.description}")
Synchronous Usage
Both methods are available on the synchronous client with the same signatures:
from qarion import QarionSyncClient
with QarionSyncClient(api_key="qk_...") as client:
results = client.search.search("marketing-analytics", "revenue")
org_results = client.search.search_organization("acme-corp", "revenue")