Skip to main content

Trending Searches

Retrieves Google Trends trending searches data for a specific country.

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​

  • Trending Searche - The country for which to retrieve trending searches. Example: 'united_states' for United States. 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 trending searches data retrieved from Google Trends as an object.

How It Works​

The Trending Searches node connects to Google Trends API and retrieves trending searches data for a specific country. When executed, the node:

  1. Validates the required inputs (Host Language, Timezone Offset, and Trending Searche)
  2. Creates a connection to Google Trends with the specified parameters
  3. Retrieves the trending searches 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 country identifier for which to retrieve trending searches

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 Trending Searche (country identifier)
  • 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 Trending Searche parameter should be a valid country identifier (e.g., 'united_states' for United States)
  • 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 trending searches data that can be used for current trend analysis