> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration recipes

> Compose bounded Qoory operations into useful application and agent workflows.

## Entity profile enrichment

1. Search one entity family with a narrow query.
2. Let the user choose when several identities are plausible.
3. Store the returned Qoory ID or slug.
4. Fetch the supported detail and only the subresources the screen needs.
5. Refresh time-sensitive market or news data independently from identity data.

## Research assistant

1. Resolve named entities in the user's question.
2. Select a small set of relevant detail or discovery operations.
3. Keep citations and observation times beside each claim.
4. Distinguish API facts from the agent's synthesis.
5. Return the request IDs used for reproducibility and support.

## Trending dashboard

Use a curated trending, ranking, mover, or narrative operation. Keep the
operation's time window and ranking type in the UI. Fetch details only for rows
the user opens instead of preloading every related entity.

## News monitor

Filter recent canonical stories by entity and time window, deduplicate by the
Qoory story ID, and store the publication time. A canonical story can summarize
several articles, so do not treat it as one publisher's verbatim article.

## X-account resolution

Search with `types: ["x_account"]`, store the opaque Qoory UUID, and follow a
returned canonical link when present. Do not assume the current handle is a
permanent identity or merge an unlinked account into a person automatically.
