​

research google-keywords

orc research google-keywords discovers keyword candidates, retrieves volume and intent, and compares ranking keywords across domains. Start with map, locales list and categories list to choose operations, locations and categories.

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

Discover keyword-research operations.

Retrieve category IDs and their hierarchy. Choose IDs from this response when using for-categories list.

Discover keywords in the selected categories. --category-intersection true requires all categories; false matches any category.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

Discover keywords relevant to a site. Supply a bare hostname with --target; use --include-subdomains to control subdomain coverage.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

Retrieve historical keyword metrics. Keep location and language consistent when comparing periods, and leave missing provider records missing.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

Discover keyword ideas from seed terms. Set a location and language, then filter candidates by search volume or organic keyword difficulty.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

Retrieve search-intent classifications for keywords in the selected language. Missing classifications remain missing.

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

Type: string. Optional.

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

Type: string. Optional.

Compare ranking keywords for two domains. --intersections true returns shared keywords; false returns keywords of target1 absent from target2.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

List locations and languages used in keyword research. Location codes are provider identifiers, not country ISO codes; check support for the requested dataset.

Discover the available keyword-research operations and their input primitives before choosing a retrieval workflow.

Compare keyword volume, difficulty and intent. Organic keyword difficulty and paid-ad competition are different metrics.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

Find keywords for which a domain ranks. Supply a bare hostname and keep location and language consistent across comparisons.

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

Type: string. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

Expand related keywords from one seed phrase. --depth controls expansion depth rather than page size; zero requests the seed level and the default is one.

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.

Type: number. Optional.

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.

Type: string. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: string. Optional.

Inspect Google results for one keyword. Choose a device with --device and a target depth of 10–100 results with --depth; the source may return fewer.

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.

Type: number. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

Find search phrases containing a seed. Use --include-seed-keyword to control whether additional seed-keyword data is requested.

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.

Type: string. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: number. Optional.

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

Type: string. Optional.

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

Type: string. Optional.

Retrieve Google Ads search volumes. These approximate counts do not directly measure unique searchers or purchasing demand.

(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

Type: string. Optional.

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

Type: string. Optional.

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

Type: number. Optional.

Compare search volumes.

Inspect search intent.

ideas, suggestions, for-site and for-categories use tokens. Pass the complete pagination.next_request unchanged to the same command with --stdin. In CLI JSON, extract data.pagination.next_request.

Request the next page only when a continuation request is present.

Do not call when next_request is null. Do not mix continuation tokens with initial filters. related, ranked and intersection use offsets; retain the conditions in next_request. There is no automatic traversal or retry.

Arrays use comma-separated values; pass booleans explicitly, for example --intersections false. For keywords containing commas, use an array inside a JSON request object with --stdin. Choose category IDs from categories list. Organic difficulty differs from ad competition, and search volume is an approximate count rather than people or purchasing demand. Null is not zero.

GET retrieval requires read scope; POST keyword retrieval requires write scope. Provider credentials are managed by the server.

The following global options can be used with orc research google-keywords:

For details and examples, see global options.