Skip to main content

Suggestions

Retrieves Google Trends keyword suggestions 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

  • Keyword - Keyword to get suggestions for. This is a required field.
  • 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.

Options

No additional options available for this node.

Output

  • Response - The keyword suggestions data retrieved from Google Trends as an object.

How It Works

The Suggestions node connects to Google Trends API and retrieves keyword suggestions 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. Retrieves the keyword suggestions data from Google Trends
  4. Returns the data as the response

Requirements

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

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 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 keyword suggestions that can be used for SEO and content planning