Skip to main content

Related Topics

Retrieves Google Trends related topics data for a specific keyword.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Host Language - The parameter hl specifies host language for accessing Google Trends. Default is 'en-US'.
  • Timeout - timeout(connect, read) in seconds. Format is "connect,read" (e.g., "2,5").
  • Timezone Offset - Timezone offset in minutes. For example US CST is 360.
  • Proxies - Https proxies for Google (optional). Should be an object with proxy configuration.
  • Retries - Number of retries total/connect/read all represented by one scalar. Default is 0.
  • Backoff Factor - A backoff factor to apply between attempts after the second try. Default is 0.
  • Keyword - Keywords to get data for. This is a required field.
  • Category to Narrow Results - Find available categories by inspecting the url when manually using Google Trends. The category starts after cat=. Default is 0.
  • Country Abbreviation - Two letter country abbreviation. For example United States is US. Default is empty.
  • Date to start from - Specific datetimes in format YYYY-MM-DDTHH YYYY-MM-DDTHH. Example: 2017-02-06T10 2017-02-12T07. Default is 'today 5-y'.
  • What Google property to filter to - Example: images. Default is empty.

Options​

No additional options available for this node.

Output​

  • Response - The related topics data retrieved from Google Trends as an object.

How It Works​

The Related Topics node connects to Google Trends API and retrieves related topics data for a specific keyword. When executed, the node:

  1. Validates the required inputs (Host Language, Timezone Offset, and Keyword)
  2. Creates a connection to Google Trends with the specified parameters
  3. Builds a payload with the keyword and other parameters
  4. Retrieves the related topics data from Google Trends
  5. Processes the data using pandas for easier consumption
  6. Returns the processed data as the response

Requirements​

  • Valid internet connection
  • Access to Google Trends service
  • Properly configured proxy settings if required by network
  • A valid keyword to search for

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Host Language
  • Empty or invalid Timezone Offset
  • Empty or invalid Keyword
  • Invalid timeout format
  • Network connectivity issues
  • Google Trends service errors
  • Proxy configuration errors

Usage Notes​

  • The Host Language parameter determines the language used for accessing Google Trends
  • The Timeout parameter should be specified as "connect,read" in seconds (e.g., "2,5")
  • The Timezone Offset should be specified in minutes (e.g., 360 for US CST)
  • The Keyword is a required field and should be relevant to your analysis
  • The Category parameter can help narrow down results to specific categories
  • The Country Abbreviation can limit results to a specific country
  • The Date range parameter controls how far back the data goes
  • The Google property filter can focus on specific Google services
  • The Proxies parameter is optional and should only be used if required by your network
  • The Retries and Backoff Factor parameters can help with reliability in unstable network conditions
  • The response contains related topics data that can be used for content planning and research