​

research google-keywords

orc research google-keywords は、キーワード候補の発見、検索数・検索意図の確認、ドメインの順位キーワード比較を行うコマンドです。map・locales list・categories list で取得機能と地域・分類を確認し、候補を広げて比較します。

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

取得機能を確認する。

キーワード探索に使うカテゴリIDと分類の親子関係を取得します。for-categories list の入力は、この一覧にある実際のIDから選びます。

指定したカテゴリに属するキーワード候補を探します。--category-intersection true はすべてのカテゴリへの一致、false はいずれかへの一致です。

One to 20 provider product or service category IDs. Discover IDs with GET /v1/research/google-keywords/categories.; csv

型: string。任意。

true requires keywords to belong to every supplied category; false accepts keywords from any supplied category. Defaults to true.

型: string。任意。

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

型: string。任意。

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

型: number。任意。

Maximum organic keyword difficulty. This differs from paid advertising competition. When omitted, no difficulty filter is applied.

型: number。任意。

Minimum provider-reported monthly average search volume. When omitted, no search-volume filter is applied.

型: number。任意。

Number of matching items to skip. Follow pagination.next_request for subsequent pages. The offset window does not guarantee access to every source result.

型: number。任意。

Ordering of matching items: source preserves provider ordering; volume_desc requests highest search volume first; difficulty_asc requests lowest organic difficulty first.; enum: source|volume_desc|difficulty_asc

型: string。任意。

Opaque continuation token returned in pagination.next_request. Send the complete next_request body to the same endpoint; do not combine this form with initial search filters.; max 4096 chars

型: string。任意。

サイトに関連するキーワードを取得します。--target にはスキームやパスを付けないホスト名を指定します。サブドメインを含めるかは --include-subdomains で選べます。

Include keywords associated with subdomains of target. Defaults to true; false ignores subdomains.

型: string。任意。

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

型: string。任意。

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

型: number。任意。

Maximum organic keyword difficulty. This differs from paid advertising competition. When omitted, no difficulty filter is applied.

型: number。任意。

Minimum provider-reported monthly average search volume. When omitted, no search-volume filter is applied.

型: number。任意。

Number of matching items to skip. Follow pagination.next_request for subsequent pages. The offset window does not guarantee access to every source result.

型: number。任意。

Ordering of matching items: source preserves provider ordering; volume_desc requests highest search volume first; difficulty_asc requests lowest organic difficulty first.; enum: source|volume_desc|difficulty_asc

型: string。任意。

Bare hostname of the website. Do not include a scheme, path or query string.; max 253 chars

型: string。任意。

Opaque continuation token returned in pagination.next_request. Send the complete next_request body to the same endpoint; do not combine this form with initial search filters.; max 4096 chars

型: string。任意。

指定したキーワードの過去の指標を取得します。地域・言語をそろえて比較し、取得元にない期間の値を0として補完しないでください。

(required) Keywords to inspect in this request. Missing provider records are not synthesized.; csv

型: string。任意。

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

型: string。任意。

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

型: number。任意。

複数の種語から新しいキーワード候補を探します。地域・言語を指定し、検索数や自然検索の難易度で候補を絞り込めます。

Keywords to inspect in this request. Missing provider records are not synthesized.; csv

型: string。任意。

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

型: string。任意。

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

型: number。任意。

Maximum organic keyword difficulty. This differs from paid advertising competition. When omitted, no difficulty filter is applied.

型: number。任意。

Minimum provider-reported monthly average search volume. When omitted, no search-volume filter is applied.

型: number。任意。

Number of matching items to skip. Follow pagination.next_request for subsequent pages. The offset window does not guarantee access to every source result.

型: number。任意。

Ordering of matching items: source preserves provider ordering; volume_desc requests highest search volume first; difficulty_asc requests lowest organic difficulty first.; enum: source|volume_desc|difficulty_asc

型: string。任意。

Opaque continuation token returned in pagination.next_request. Send the complete next_request body to the same endpoint; do not combine this form with initial search filters.; max 4096 chars

型: string。任意。

キーワードの検索意図を取得します。言語を指定して候補を分類する際に使用します。欠損した分類は推測で埋めません。

(required) Keywords to inspect in this request. Missing provider records are not synthesized.; csv

型: string。任意。

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

型: string。任意。

2つのドメインの順位キーワードを比較します。--intersections true は共通語、false は target1 にあって target2 にない語を返します。

true requests ranking keywords shared by target1 and target2. false requests keywords of target1 absent from target2. Defaults to true.

型: string。任意。

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

型: string。任意。

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

型: number。任意。

Maximum organic keyword difficulty. This differs from paid advertising competition. When omitted, no difficulty filter is applied.

型: number。任意。

Minimum provider-reported monthly average search volume. When omitted, no search-volume filter is applied.

型: number。任意。

Number of matching items to skip. Follow pagination.next_request for subsequent pages. The offset window does not guarantee access to every source result.

型: number。任意。

Ordering of matching items: source preserves provider ordering; volume_desc requests highest search volume first; difficulty_asc requests lowest organic difficulty first.; enum: source|volume_desc|difficulty_asc

型: string。任意。

(required) Bare hostname of the website. Do not include a scheme, path or query string.; max 253 chars

型: string。任意。

(required) Bare hostname of the website. Do not include a scheme, path or query string.; max 253 chars

型: string。任意。

キーワード調査で使用できる地域・言語を取得します。地域は国のISOコードではなく取得元のlocation codeを使います。データセットごとの対応を確認してください。

キーワード探索・検索数・検索意図・順位比較などの取得機能と入力の入口を確認します。最初の調査で使用する操作を選ぶときに使います。

複数のキーワードについて検索数、難易度、検索意図を比較します。自然検索の難易度と広告の競合度は異なる指標です。

(required) Keywords to inspect in this request. Missing provider records are not synthesized.; csv

型: string。任意。

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

型: string。任意。

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

型: number。任意。

指定ドメインが検索順位を持つキーワードを取得します。--target はホスト名で指定し、地域・言語を比較対象とそろえてください。

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

型: string。任意。

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

型: number。任意。

Maximum organic keyword difficulty. This differs from paid advertising competition. When omitted, no difficulty filter is applied.

型: number。任意。

Minimum provider-reported monthly average search volume. When omitted, no search-volume filter is applied.

型: number。任意。

Number of matching items to skip. Follow pagination.next_request for subsequent pages. The offset window does not guarantee access to every source result.

型: number。任意。

Ordering of matching items: source preserves provider ordering; volume_desc requests highest search volume first; difficulty_asc requests lowest organic difficulty first.; enum: source|volume_desc|difficulty_asc

型: string。任意。

(required) Bare hostname of the website. Do not include a scheme, path or query string.; max 253 chars

型: string。任意。

一つの種語から関連キーワードを探します。--depth は探索の深さで、ページ件数ではありません。0は種語の階層、既定値は1です。

Related-keyword expansion depth, from 0 to 4. Zero requests the seed level; larger values explore more levels. Defaults to 1. This is not the page size and does not guarantee a result count.

型: number。任意。

Request provider data for the seed keyword in addition to discovered keywords. Orchestor defaults this to true; set false to omit the extra seed data.

型: string。任意。

(required) Search term or seed phrase. Leading and trailing whitespace is removed. Use at most 10 whitespace-separated words.; max 80 chars

型: string。任意。

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

型: string。任意。

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

型: number。任意。

Maximum organic keyword difficulty. This differs from paid advertising competition. When omitted, no difficulty filter is applied.

型: number。任意。

Minimum provider-reported monthly average search volume. When omitted, no search-volume filter is applied.

型: number。任意。

Number of matching items to skip. Follow pagination.next_request for subsequent pages. The offset window does not guarantee access to every source result.

型: number。任意。

Ordering of matching items: source preserves provider ordering; volume_desc requests highest search volume first; difficulty_asc requests lowest organic difficulty first.; enum: source|volume_desc|difficulty_asc

型: string。任意。

一つのキーワードのGoogle検索結果を取得します。--device で端末を選び、--depth で10〜100件の取得目標を指定します。実際の件数は取得元によります。

Requested SERP result depth. Orchestor accepts 10 to 100 and defaults to 10. This is a result-count target, not related-keyword expansion depth. The source can return fewer results.

型: number。任意。

Device type for the Google results. Defaults to desktop; use mobile for mobile-device results.; enum: desktop|mobile

型: string。任意。

(required) Search term or seed phrase. Leading and trailing whitespace is removed. Use at most 10 whitespace-separated words.; max 80 chars

型: string。任意。

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

型: string。任意。

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

型: number。任意。

一つの種語を含む検索フレーズを取得します。種語自体の取得データを含めるかは --include-seed-keyword で選べます。

Request provider data for the seed keyword in addition to discovered keywords. Orchestor defaults this to true; set false to omit the extra seed data.

型: string。任意。

Search term or seed phrase. Leading and trailing whitespace is removed. Use at most 10 whitespace-separated words.; max 80 chars

型: string。任意。

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

型: string。任意。

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

型: number。任意。

Maximum organic keyword difficulty. This differs from paid advertising competition. When omitted, no difficulty filter is applied.

型: number。任意。

Minimum provider-reported monthly average search volume. When omitted, no search-volume filter is applied.

型: number。任意。

Number of matching items to skip. Follow pagination.next_request for subsequent pages. The offset window does not guarantee access to every source result.

型: number。任意。

Ordering of matching items: source preserves provider ordering; volume_desc requests highest search volume first; difficulty_asc requests lowest organic difficulty first.; enum: source|volume_desc|difficulty_asc

型: string。任意。

Opaque continuation token returned in pagination.next_request. Send the complete next_request body to the same endpoint; do not combine this form with initial search filters.; max 4096 chars

型: string。任意。

指定した語のGoogle Ads検索数を取得します。検索数は概算回数であり、検索した人数や購買需要を直接表す値ではありません。

(required) Search terms to measure. Each term must contain at most 80 characters and 10 whitespace-separated words. Leading and trailing whitespace is removed. Similar terms may be combined by Google Ads.; csv

型: string。任意。

(required) Language code supported by the Google Ads dataset. Targeting is required; it does not default to your workspace locale.

型: string。任意。

(required) DataForSEO Google Ads location identifier. This is not a country ISO code; availability may differ from the Labs locales endpoint.

型: number。任意。

検索数を比較する。

検索意図を調べる。

ideas・suggestions・for-site・for-categoriesはトークン方式です。pagination.next_request を変更せず、同じコマンドの --stdin へ渡します。CLIのJSON出力では data.pagination.next_request から取り出してください。

返された継続リクエストがある場合だけ、次のページを取得します。

next_request がnullの場合は呼び出しません。継続トークンと初回の検索条件は混ぜられません。related・ranked・intersectionはoffset方式で、next_request の条件を維持します。自動巡回や自動再試行はありません。

配列はカンマ区切り、真偽値は --intersections false のように明示します。カンマを含むキーワードは --stdin のJSONオブジェクト内の配列で渡してください。カテゴリIDは categories list の実際の結果から選びます。自然検索の難易度と広告の競合度は異なり、検索数は概算回数です。人数や購買需要と同一視せず、nullを0へ補完しません。

GETの取得はread、POSTのキーワード取得はwriteスコープが必要です。 プロバイダーのキーはサーバー側で管理します。

orc research google-keywords では、次のグローバルオプションを使用できます。

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