---
title: research google-trends
description: Retrieve Google Trends interest and related queries.
canonical_url: https://orchestor.io/docs/en/cli/research/google-trends
markdown_url: https://orchestor.io/docs/en/cli/research/google-trends.md
contentType: reference
---

# research google-trends

`orc research google-trends` retrieves interest over time, geographic interest, related queries and topics. Choose a location, language, time window and result types to compare relative interest in search terms.

Authenticate the CLI and select an accessible Workspace. Use `--workspace` to set the scope for this call.

## Usage

```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
```

*Compare relative interest in two search terms.*

## Subcommands

### `get`

Retrieve interest over time, geographic interest, related queries and topics for a location, language and time window. Graphs and maps accept up to five terms; related queries or topics require exactly one.

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

#### Unique 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

Type: `string`. Optional.

```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

Type: `string`. Optional.

```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.

Type: `string`. Optional.

```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.

Type: `number`. Optional.

```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

Type: `string`. Optional.

```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

Type: `string`. Optional.

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

## Examples

### Retrieve related queries and topics for one term.

```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
```

*Retrieve related queries and topics for one term.*

## Interpreting comparisons

A score of 100 marks the peak within the comparison, not an absolute search count. Zero does not necessarily mean zero demand. Native top/rising results and missing values are retained without conversion into a proprietary demand score.

## Permissions

API keys require write scope. Provider credentials are managed by the server.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc research google-trends`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

## Related commands

- Research overview
- [Global options](https://orchestor.io/docs/en/cli/global-flags.md)

---

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