Skip to main content

Top Charts

Retrieves Google Trends top charts data for a specific year and 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​

  • Top Chart Date - The year for which to retrieve top chart data. Example: 2019 for the year 2019 Top Chart data. Note: Google removed support for monthly queries. 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.
  • Country Abbreviation - Two letter country abbreviation. For example United States is US. Default is 'GLOBAL'.

Options​

No additional options available for this node.

Output​

  • Response - The top charts data retrieved from Google Trends as an object.

How It Works​

The Top Charts node connects to Google Trends API and retrieves top charts data for a specific year and country. When executed, the node:

  1. Validates the required inputs (Host Language, Timezone Offset, Top Chart Date, and Country Abbreviation)
  2. Creates a connection to Google Trends with the specified parameters
  3. Retrieves the top charts data from Google Trends for the specified year and country
  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 year for which to retrieve top chart data
  • A valid country abbreviation

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 Top Chart Date
  • Empty or invalid Country Abbreviation
  • 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 Top Chart Date should be a valid year (e.g., 2019)
  • The Country Abbreviation should be a valid two-letter country code (e.g., 'US' for United States)
  • The default Country Abbreviation is 'GLOBAL' which retrieves worldwide data
  • 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 top charts data that can be used for trend analysis and research