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

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

使い方

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語を指定します。

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。任意。

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。任意。

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。任意。

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。任意。

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。任意。

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。任意。

terminal
orc research google-trends get --type <value>

使用例

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

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 では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。

関連項目