Actions7
Interest by Region
AI-generatedOverview
This node operation retrieves Google Trends interest data by region for specified keywords. It allows users to analyze how interest in certain keywords varies geographically over a selected time period and resolution (country, region, city, or DMA). This is useful for marketers, researchers, and analysts who want to understand regional interest patterns and trends for specific topics or products.
Use Case Examples
- A marketing analyst wants to see how interest in 'electric cars' varies across different US states over the past year.
- A researcher is studying regional interest in 'climate change' across multiple countries during a specific date range.
Properties
| Name | Meaning |
|---|---|
| Keywords | Comma-separated list of keywords or a single keyword to analyze interest for. |
| Start Date | Start date for the analysis period. |
| End Date | End date for the analysis period. |
| Geo Locations | Comma-separated list of geographic region codes or a single geo code to filter the data. |
| Resolution | Geographic resolution level for the interest data (Country, Region, City, or DMA). |
| Language | Language code for the data. |
| Timezone | Timezone offset in minutes to adjust the data timestamps. |
| Category | Category number to filter the interest data by category. |
Output
JSON
operation- The operation performed, here it will be 'interestByRegion'.data- The interest by region data returned from the Google Trends API for the specified parameters.
Dependencies
- @alkalisummer/google-trends-js library for accessing Google Trends data
Troubleshooting
- Invalid article keys format error does not apply here but users should ensure keywords and geo locations are correctly formatted as comma-separated strings.
- If the API returns an error, check that the date formats for start and end times are valid and that the geo codes and resolution values are supported.
- Ensure the timezone offset is correctly set as an integer representing minutes offset from UTC.