​

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.

Compare relative interest in two search terms.

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.

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.

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

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

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.

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

Type: string. Optional.

Retrieve related queries and topics for one term.

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.

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

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

For details and examples, see global options.