Skip to main content

Interest By Region

Retrieves Google Trends interest by region 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​

  • Resolution - The geographical resolution for the data. Options are:
    • CITY
    • COUNTRY
    • DMA
    • REGION
    • Default is CITY.

Output​

  • Response - The interest by region data retrieved from Google Trends as an object.

How It Works​

The Interest By Region node connects to Google Trends API and retrieves interest data by geographical region 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 interest by region data from Google Trends
  5. Formats the data for easier consumption
  6. Returns the formatted 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 Resolution option controls the geographical granularity of the 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