---
title: sources
description: 回答に現れたsourceと引用・競合gapを調べる。
canonical_url: https://orchestor.io/docs/cli/source
markdown_url: https://orchestor.io/docs/cli/source.md
contentType: reference
---

# sources

`orc sources` は、Workspaceの回答からsource domain・URL・引用の集計と、競合を含む回答のsource gapを調べるコマンドです。domain、host、URL単位の表示を使い分け、期間・brand・topic・tag・platformで対象の回答を絞れます。

保存済みの取得根拠と引用を対象にし、新しい観測を開始しません。`--project` は互換queryですが、現在のendpointはproject filterを適用しません。対象を絞るにはbrand、topic、prompt tagなどの対応filterを使います。

## 使い方

```bash title="terminal"
orc sources domains list
```

*source domainを一覧表示します。*

## 期間とcohort

開始と終了は含むUTC日付 `YYYY-MM-DD` です。`top` は現在の取得または引用があるsource、`new` は期間内に初取得されたsource、`trending` と `losing` は取得数の増減です。cohortは重複可能です。trending/losingは両方の日付が必要で、直前の同じ日数の期間と比較します。両方の境界がなければ空になります。

domain一覧のsort既定はcohortなしでcitation_count、topでretrieval_count、newでfirst_seen_at、trending/losingでretrieval_changeです。losingは既定昇順、他は降順で、`--order` で変更できます。

## サブコマンド

### `gaps list`

回答に含まれる異なる設定済み競合の数を `--min-competitors` で指定できます。`--view` はdomain・host・urlで、既定domainです。指定した言及brandの条件は `--mentioned-brand-operator or` / `and` でany/allを選びます。hostname・URL・titleのsearchは大文字小文字を区別しません。

```bash title="terminal"
orc sources gaps list [options]
```

#### 固有のオプション

##### `--view`

Grouping axis: domain combines subdomains under their registrable domain; host keeps captured hostnames; url keeps individual citation URLs. Defaults to domain.; enum: domain|host|url

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --view <value>
```

##### `--min-competitors`

Minimum distinct configured competitors found in an answer.

型: `number`。任意。

```bash title="terminal"
orc sources gaps list --min-competitors <value>
```

##### `--start-date`

Inclusive UTC start date (YYYY-MM-DD). Omit for no lower bound.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --start-date <value>
```

##### `--end-date`

Inclusive UTC end date (YYYY-MM-DD). Omit for no upper bound.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --end-date <value>
```

##### `--search`

Case-insensitive source hostname, URL, or title search.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --search <value>
```

##### `--filter[platform]`

Comma-separated platform identifiers, such as openai or anthropic. Values are trimmed and lowercased. Matches any selected platform; omit or send an empty value for no platform filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[platform] <value>
```

##### `--filter[topic-id]`

Comma-separated topic IDs for the answer population. Matches any selected topic in the workspace. Omit or send an empty value for no topic filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[topic-id] <value>
```

##### `--filter[brand-id]`

Comma-separated IDs of the brands that own the answer prompts. Matches any selected parent brand in the workspace; this does not select every brand mentioned in an answer. Omit for no parent-brand filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[brand-id] <value>
```

##### `--filter[tag]`

Comma-separated prompt tag names, not tag IDs. Values are trimmed and lowercased. Matches any selected name. Omit or send an empty value for no tag filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[tag] <value>
```

##### `--filter[mentioned-brand-id]`

Comma-separated competitor Brand IDs that must be mentioned in qualifying answers.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[mentioned-brand-id] <value>
```

##### `--filter[country]`

Comma-separated ISO 3166-1 alpha-2 country codes for qualifying prompts.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[country] <value>
```

##### `--mentioned-brand-operator`

Whether any or all selected mentioned Brand IDs must occur in a qualifying answer.; enum: or|and

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --mentioned-brand-operator <value>
```

##### `--filter[domain-classification]`

Comma-separated SourceDomainClassification values.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[domain-classification] <value>
```

##### `--filter[url-classification]`

Comma-separated SourceUrlClassification values.

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --filter[url-classification] <value>
```

##### `--sort`

Field used to order the derived gap rows.; enum: source|competitor_count|retrieval_count|retrieved_percentage|retrieval_rate|citation_rate|gap_score

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --sort <value>
```

##### `--order`

Sort direction.; enum: asc|desc

型: `string`。任意。

```bash title="terminal"
orc sources gaps list --order <value>
```

##### `--page`

One-based page number. Defaults to 1; values above 100000 are capped. Reuse the same filters when incrementing the page.

型: `number`。任意。

```bash title="terminal"
orc sources gaps list --page <value>
```

### `domains list`

domain viewはPublic Suffix Listでsubdomainを登録可能domainに集約し、host viewは取得した正規化hostnameを維持します。domainとhostでclassificationの語彙が異なります。`--page` は1始まりで既定1、100000より上はcapします。

```bash title="terminal"
orc sources domains list [options]
```

#### 固有のオプション

##### `--project`

Compatibility query parameter; this endpoint does not apply a project filter. Use the supported brand, topic or prompt-tag filters to narrow the workspace data.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --project <value>
```

##### `--view`

Grouping axis: domain combines subdomains under their registrable domain using the Public Suffix List; host keeps normalized captured hostnames. Defaults to domain.; enum: domain|host

型: `string`。任意。

```bash title="terminal"
orc sources domains list --view <value>
```

##### `--start-date`

Inclusive UTC start date (YYYY-MM-DD). Omit for no lower bound. For trending or losing, provide both start_date and end_date. The comparison period immediately precedes the selected period and has the same inclusive day count. Without both bounds these cohorts return no rows.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --start-date <value>
```

##### `--end-date`

Inclusive UTC end date (YYYY-MM-DD). Omit for no upper bound. For trending or losing, provide both start_date and end_date. The comparison period immediately precedes the selected period and has the same inclusive day count. Without both bounds these cohorts return no rows.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --end-date <value>
```

##### `--cohort`

Optional source subset: top includes any current retrieval or citation; new requires a retrieval and first retrieval within the selected period; trending and losing require a positive or negative retrieval change. Cohorts can overlap. For trending or losing, provide both start_date and end_date. The comparison period immediately precedes the selected period and has the same inclusive day count. Without both bounds these cohorts return no rows.; enum: top|new|trending|losing

型: `string`。任意。

```bash title="terminal"
orc sources domains list --cohort <value>
```

##### `--filter[platform]`

Comma-separated platform identifiers, such as openai or anthropic. Values are trimmed and lowercased. Matches any selected platform; omit or send an empty value for no platform filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --filter[platform] <value>
```

##### `--filter[topic-id]`

Comma-separated topic IDs for the answer population. Matches any selected topic in the workspace. Omit or send an empty value for no topic filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --filter[topic-id] <value>
```

##### `--filter[brand-id]`

Comma-separated IDs of the brands that own the answer prompts. Matches any selected parent brand in the workspace; this does not select every brand mentioned in an answer. Omit for no parent-brand filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --filter[brand-id] <value>
```

##### `--filter[tag]`

Comma-separated prompt tag names, not tag IDs. Values are trimmed and lowercased. Matches any selected name. Omit or send an empty value for no tag filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --filter[tag] <value>
```

##### `--filter[classification]`

Comma-separated classification values. Matches any supplied value; omit to include all classifications. In host view use host-role values; in domain view use domain classification values.

型: `string`。任意。

```bash title="terminal"
orc sources domains list --filter[classification] <value>
```

##### `--sort`

Sort field. When omitted: citation_count without cohort; retrieval_count for top; first_seen_at for new; retrieval_change for trending or losing. retrieval_change requires cohort.; enum: hostname|classification|retrieval_count|retrieval_change|retrieval_rate|retrieval_frequency|citation_count|citation_rate|url_count|share_of_voice|first_seen_at|last_seen_at

型: `string`。任意。

```bash title="terminal"
orc sources domains list --sort <value>
```

##### `--order`

Sort direction. When omitted, losing uses ascending order and all other cases use descending order. Set explicitly to override the cohort default.; enum: asc|desc

型: `string`。任意。

```bash title="terminal"
orc sources domains list --order <value>
```

##### `--page`

One-based page number. Defaults to 1; values above 100000 are capped. Reuse the same filters when incrementing the page.

型: `number`。任意。

```bash title="terminal"
orc sources domains list --page <value>
```

### `domains get`

host viewの一覧で返されたsource-domain hostnameを指定して詳細を取得します。domain集約の表示値と区別してください。

```bash title="terminal"
orc sources domains get <id> [options]
```

### `urls list`

source URLを一覧表示します。cursorを返されたまま使い、期間とfilterを維持します。cohortを指定しない既定sortはcitation_countです。retrieval_count・retrieval_changeによるsortにはcohortが必要です。

```bash title="terminal"
orc sources urls list [options]
```

#### 固有のオプション

##### `--project`

Compatibility query parameter; this endpoint does not apply a project filter. Use the supported brand, topic or prompt-tag filters to narrow the workspace data.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --project <value>
```

##### `--start-date`

Inclusive UTC start date (YYYY-MM-DD). Omit for no lower bound. For trending or losing, provide both start_date and end_date. The comparison period immediately precedes the selected period and has the same inclusive day count. Without both bounds these cohorts return no rows.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --start-date <value>
```

##### `--end-date`

Inclusive UTC end date (YYYY-MM-DD). Omit for no upper bound. For trending or losing, provide both start_date and end_date. The comparison period immediately precedes the selected period and has the same inclusive day count. Without both bounds these cohorts return no rows.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --end-date <value>
```

##### `--cohort`

Optional source subset: top includes any current retrieval or citation; new requires a retrieval and first retrieval within the selected period; trending and losing require a positive or negative retrieval change. Cohorts can overlap. For trending or losing, provide both start_date and end_date. The comparison period immediately precedes the selected period and has the same inclusive day count. Without both bounds these cohorts return no rows.; enum: top|new|trending|losing

型: `string`。任意。

```bash title="terminal"
orc sources urls list --cohort <value>
```

##### `--filter[platform]`

Comma-separated platform identifiers, such as openai or anthropic. Values are trimmed and lowercased. Matches any selected platform; omit or send an empty value for no platform filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --filter[platform] <value>
```

##### `--filter[topic-id]`

Comma-separated topic IDs for the answer population. Matches any selected topic in the workspace. Omit or send an empty value for no topic filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --filter[topic-id] <value>
```

##### `--filter[brand-id]`

Comma-separated IDs of the brands that own the answer prompts. Matches any selected parent brand in the workspace; this does not select every brand mentioned in an answer. Omit for no parent-brand filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --filter[brand-id] <value>
```

##### `--filter[tag]`

Comma-separated prompt tag names, not tag IDs. Values are trimmed and lowercased. Matches any selected name. Omit or send an empty value for no tag filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --filter[tag] <value>
```

##### `--filter[classification]`

Comma-separated classification values. Matches any supplied value; omit to include all classifications. For citation aggregates, classification_scope selects the vocabulary.

型: `string`。任意。

```bash title="terminal"
orc sources urls list --filter[classification] <value>
```

##### `--sort`

Sort field. When omitted: citation_count without cohort; retrieval_count for top; first_seen_at for new; retrieval_change for trending or losing. retrieval_count and retrieval_change require cohort.; enum: url|hostname|retrieval_count|retrieval_change|citation_count|share_of_voice|first_seen_at|last_seen_at

型: `string`。任意。

```bash title="terminal"
orc sources urls list --sort <value>
```

##### `--order`

Sort direction. When omitted, losing uses ascending order and all other cases use descending order. Set explicitly to override the cohort default.; enum: asc|desc

型: `string`。任意。

```bash title="terminal"
orc sources urls list --order <value>
```

### `urls get`

一覧で返されたURLをURL encodeした値で詳細を取得します。新しいsourceの登録やURLのcrawlを要求する操作ではありません。

```bash title="terminal"
orc sources urls get <id> [options]
```

### `citations list`

`--group-by` にdomain、hostname、url、classification、dateをカンマで指定します。既定のgroupはありません。dateを含む場合は `--bucket-width day` / `week` / `month` が必要です。classification scopeはdomain・host・urlを選択します。

```bash title="terminal"
orc sources citations list [options]
```

#### 固有のオプション

##### `--project`

Compatibility query parameter; this endpoint does not apply a project filter. Use the supported brand, topic or prompt-tag filters to narrow the workspace data.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --project <value>
```

##### `--start-date`

Inclusive UTC start date (YYYY-MM-DD). Omit for no lower bound.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --start-date <value>
```

##### `--end-date`

Inclusive UTC end date (YYYY-MM-DD). Omit for no upper bound.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --end-date <value>
```

##### `--group-by`

One or more grouping axes separated by commas: domain, hostname, url, classification or date. No default. Use bucket_width when date is included.

型: `string`。必須。

```bash title="terminal"
orc sources citations list --group-by <value>
```

##### `--bucket-width`

Calendar date bucket width. Required when group_by includes date; otherwise omit it.; enum: day|week|month

型: `string`。任意。

```bash title="terminal"
orc sources citations list --bucket-width <value>
```

##### `--classification-scope`

Selects whether group_by=classification returns domain classifications or URL classifications.; enum: domain|host|url

型: `string`。任意。

```bash title="terminal"
orc sources citations list --classification-scope <value>
```

##### `--filter[hostname]`

Comma-separated hostnames.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[hostname] <value>
```

##### `--filter[domain]`

Comma-separated registrable domains; subdomains are normalized to their registrable domain.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[domain] <value>
```

##### `--filter[url]`

Comma-separated URLs.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[url] <value>
```

##### `--filter[classification]`

Comma-separated classification values. Matches any supplied value; omit to include all classifications. For citation aggregates, classification_scope selects the vocabulary.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[classification] <value>
```

##### `--filter[platform]`

Comma-separated platform identifiers, such as openai or anthropic. Values are trimmed and lowercased. Matches any selected platform; omit or send an empty value for no platform filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[platform] <value>
```

##### `--filter[topic-id]`

Comma-separated topic IDs for the answer population. Matches any selected topic in the workspace. Omit or send an empty value for no topic filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[topic-id] <value>
```

##### `--filter[brand-id]`

Comma-separated IDs of the brands that own the answer prompts. Matches any selected parent brand in the workspace; this does not select every brand mentioned in an answer. Omit for no parent-brand filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[brand-id] <value>
```

##### `--filter[tag]`

Comma-separated prompt tag names, not tag IDs. Values are trimmed and lowercased. Matches any selected name. Omit or send an empty value for no tag filter. Combines with other filter fields using AND.

型: `string`。任意。

```bash title="terminal"
orc sources citations list --filter[tag] <value>
```

## 使用例

### 増えているsourceを期間比較します。

```bash title="terminal"
orc sources domains list --cohort trending --start-date 2026-09-01 --end-date 2026-09-30
```

*増えているsourceを期間比較します。*

### 日次引用数を取得します。

```bash title="terminal"
orc sources citations list --group-by date,domain --bucket-width day --json
```

*日次引用数を取得します。*

### 競合gapをURL単位で調べます。

```bash title="terminal"
orc sources gaps list --view url --min-competitors 2
```

*競合gapをURL単位で調べます。*

## filterの対象

platform・topic・brand・tagのcomma-separated値は同じfield内でanyを満たし、異なるfield同士はANDです。brandは回答promptを所有するbrandで、任意の言及brandではありません。tagはIDでなく名前です。domain filterはsubdomainを登録可能domainへ正規化します。classification値はviewとscopeに合わせます。

## 必要な権限

認証し、対象Workspaceを選択して実行します。対象Workspaceへのアクセスが必要です。

## グローバルオプション

`orc sources` では、次の[グローバルオプション](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)