--- title: fanout-queries description: 観測された検索・shoppingクエリーを取得する。 canonical_url: https://orchestor.io/docs/cli/fanout-query markdown_url: https://orchestor.io/docs/cli/fanout-query.md contentType: reference --- # fanout-queries `orc fanout-queries list` は、Workspaceに保存されたAPI-provider応答とbrowser観測の検索・shopping query出現記録を取得します。prompt、観測slice、model、brand、期間で絞り込み、特定の観測で行われた検索展開を確認できます。 認証と対象Workspaceへのアクセスが必要です。この操作は新しい検索を実行せず、集計metricsも返しません。集計にはquery-fanout reportを使用します。同じquery文が別の観測や実行に繰り返し出現することがあります。 ## 使い方 ```bash title="terminal" orc fanout-queries list --workspace ``` *保存されたquery出現記録を取得します。* ## サブコマンド ### `list` `--type search` または `shopping`、`--prompt-id`、`--observation-slice-id`、`--model-id`、`--brand-id` を組み合わせて取得します。観測slice IDは1件のbrowser観測で見つかった語に限定します。結果は `generated_at`、IDの降順で、条件を保持してcursorをたどります。 ```bash title="terminal" orc fanout-queries list [options] ``` #### 固有のオプション ##### `--type` Exact query kind. search selects search-style terms; shopping selects shopping terms. Omit to include both kinds.; enum: search|shopping 型: `string`。任意。 ```bash title="terminal" orc fanout-queries list --type ``` ##### `--prompt-id` Exact source prompt ID. Omit to include all prompts and rows without a prompt reference. 型: `string`。任意。 ```bash title="terminal" orc fanout-queries list --prompt-id ``` ##### `--observation-slice-id` Exact browser observation slice ID. Excludes API-provider rows, which have no slice reference. Omit to include both provenance paths. 型: `string`。任意。 ```bash title="terminal" orc fanout-queries list --observation-slice-id ``` ##### `--model-id` Exact stored model identifier. Browser observations use the model channel in this field; use a value returned by this endpoint. Omit to include all models. 型: `string`。任意。 ```bash title="terminal" orc fanout-queries list --model-id ``` ##### `--brand-id` Exact stored brand ID. Browser-observation rows have no brand reference and are excluded when this filter is set. Omit to include all brands and unassigned rows. 型: `string`。任意。 ```bash title="terminal" orc fanout-queries list --brand-id ``` ##### `--start-date` Inclusive timestamp lower bound supplied as a date (`YYYY-MM-DD`), starting at midnight. Omit for no lower bound. 型: `string`。任意。 ```bash title="terminal" orc fanout-queries list --start-date ``` ##### `--end-date` Inclusive timestamp upper bound supplied as a date (`YYYY-MM-DD`). The current query compares generated_at to midnight at the start of this date, not the end of the day. Omit for no upper bound. 型: `string`。任意。 ```bash title="terminal" orc fanout-queries list --end-date ``` ## 使用例 ### 質問のshopping検索展開を確認する ```bash title="terminal" orc fanout-queries list --prompt-id --type shopping --workspace --json ``` *質問のshopping検索展開を確認する* ### UTCの日付範囲で取得する 開始日・終了日は `YYYY-MM-DD` のUTC暦日で、両端を含みます。 ```bash title="terminal" orc fanout-queries list --start-date 2026-10-01 --end-date 2026-10-03 --workspace ``` *UTCの日付範囲で取得する* ## 絞り込みと空の結果 フィルターはANDで組み合わせ、省略した条件は制限しません。ページを続ける場合は同じ条件で `next_cursor` を使用します。 空でないページのstateは `observed` です。空ページの `fanout_availability` はフィルターを適用しないWorkspace全体の収集根拠とlifecycleを示します。件数でも、検索が一度も起きなかった証明でもありません。 ## Aggregate query fanouts The Alpha `POST /v1/reports/fanout-aggregates` operation aggregates stored search query occurrences from API answers and completed browser observation slices. It uses actual fanout evidence. The existing query-fanouts report retains its legacy citation-based metric. Shopping queries are outside this report. Use `group_by: "query"` (default) to group after trimming, lowercasing and collapsing whitespace. `variations` lists up to 100 distinct original query strings, with `variation_count` and `variations_has_more` describing the full set. `share` is the group's occurrence count divided by all grouped occurrences. `execution_count` counts distinct linked executions; `per_execution_rate` divides this by `eligible_execution_count`, including confirmed empty captures. Unavailable captures are excluded. Rows with an unlinked historical occurrence return a null rate. API and browser copies linked to the same slice are counted once per original query. Use `group_by: "term_ngram"` with `ngram_size` from 1 through 5 (default 1) for contiguous terms split at non-alphanumeric characters. Repeated n-grams within one query count as repeated occurrences; execution counts remain distinct. N-gram shares use the total number of n-gram occurrences. Supply inclusive UTC `start_date`/`end_date`; optional `prompt_ids` and `model_ids` restrict both occurrences and the execution denominator. An empty filter array selects no executions. Unknown fields/groupings and `ngram_size` with query grouping return 400. `limit` and `offset` page the count-ranked results after shares are calculated. ```bash orc reports fanout-aggregates --start-date 2026-11-01 --end-date 2026-11-02 --group-by term_ngram --ngram-size 2 ``` MCP: `get_fanout_aggregate_report` accepts the same JSON fields. ## グローバルオプション `orc fanout-queries` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。 - [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97) - [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9) - [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B) - [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B) - [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F) - [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA) - [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA) - [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B) - [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B) - [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A) - [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D) - [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5) - [`--limit`](https://orchestor.io/docs/cli/global-flags.md) - [`--cursor`](https://orchestor.io/docs/cli/global-flags.md) - [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B) - [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B) - [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97) - [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93) - [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89) - [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91) 各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。 --- [Documentation index](https://orchestor.io/docs/llms.txt)