---
title: research google-trends
description: Google Trendsの関心度・関連クエリを取得する。
canonical_url: https://orchestor.io/docs/cli/research/google-trends
markdown_url: https://orchestor.io/docs/cli/research/google-trends.md
contentType: reference
---

# research google-trends

`orc research google-trends` は、関心度の推移・地域分布・関連クエリ・トピックを取得するコマンドです。地域・言語・期間と取得する結果の種類を指定し、検索語の相対的な関心度を比較します。

認証済みのCLIと、アクセス可能なWorkspaceが必要です。`--workspace` で今回の対象を指定できます。

## 使い方

```bash title="terminal"
orc research google-trends get --keywords "生成AI,AI検索" --location-code 2392 --language-code ja --time-range past_12_months --workspace <workspace-id> --json
```

*2つの検索語の関心度を比較する。*

## サブコマンド

### `get`

指定した地域・言語・期間で関心度の推移、地域分布、関連クエリ、トピックを取得します。グラフと地域比較は最大5語、関連クエリ・トピックを含める場合は1語を指定します。

```bash title="terminal"
orc research google-trends get [options]
```

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

##### `--item-types`

Requested result types: graph for interest over time, map for geographic interest, topics_list for related topics, and queries_list for related searches. Topic and query lists require exactly one keyword.; csv of: google_trends_graph|google_trends_map|google_trends_topics_list|google_trends_queries_list

型: `string`。任意。

```bash title="terminal"
orc research google-trends get --item-types <value>
```

##### `--keywords`

(required) Search terms to compare. Specify exactly one term when requesting related topics or related queries in item_types. Leading and trailing whitespace is removed.; csv

型: `string`。任意。

```bash title="terminal"
orc research google-trends get --keywords <value>
```

##### `--language-code`

(required) Provider language code for the request. Support depends on the upstream dataset; Labs combinations are available from the locales endpoint.

型: `string`。任意。

```bash title="terminal"
orc research google-trends get --language-code <value>
```

##### `--location-code`

(required) Provider location identifier for geographic targeting. This is not a country ISO code. Supported locations depend on the upstream dataset.

型: `number`。任意。

```bash title="terminal"
orc research google-trends get --location-code <value>
```

##### `--time-range`

Relative time window for the comparison. Scores are normalized within the requested comparison and are not absolute search counts.; enum: past_hour|past_4_hours|past_day|past_7_days|past_30_days|past_90_days|past_12_months|past_5_years

型: `string`。任意。

```bash title="terminal"
orc research google-trends get --time-range <value>
```

##### `--type`

Google search surface: web, news, youtube, images, or froogle for Google Shopping.; enum: web|news|youtube|images|froogle

型: `string`。任意。

```bash title="terminal"
orc research google-trends get --type <value>
```

## 使用例

### 一つの語の関連クエリ・トピックを取得する。

```bash title="terminal"
orc research google-trends get --keywords "生成AI" --location-code 2392 --language-code ja --item-types google_trends_queries_list,google_trends_topics_list --workspace <workspace-id> --json
```

*一つの語の関連クエリ・トピックを取得する。*

## 比較結果の読み方

100は比較範囲のピークを表す相対指数で、絶対検索回数ではありません。0は必ずしも需要ゼロを意味しません。取得元のtop/risingと欠損値を保持し、独自の需要スコアには変換しません。

## 必要な権限

APIキーではwriteスコープが必要です。 プロバイダーのキーはサーバー側で管理します。

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

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

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

## 関連項目

- 調査CLIの概要
- [グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)